Setup

Este artículo le muestra cómo configurarse rápidamente como desarrollador y comenzar a probar nuestras API en Wink.

Las pruebas siempre deben realizarse en nuestroentorno de puesta en escenaHay muchos menos datos allí, pero eres libre de probar tanto como quieras sin imponerte al entorno de producción.

Una vez que esté listo para comenzar, certificaremos su cuenta y aplicación, y podrá lanzarla en nuestro entorno de producción.

Siga estos pasos:

1. Registro tu cuenta de usuario en Wink
2. Crear una cuenta de agente de viajes o un cuenta de afiliado.
3. Crear una aplicación donde lo asocias con la cuenta que creaste en el Paso 2.
4. Una vez que hayas creado tu Application, guarde el ID del cliente y el secreto del cliente en un lugar seguro.

CDN

En Wink, utilizamos Cloudinary para todos nuestros recursos de imagen y vídeo. Al acceder a nuestro inventario de viajes, tendrá acceso completo a todas las funciones avanzadas de Cloudinary.

Nuestro cloud_name es traveliko.

Nublado

• Empezando
• SDK
• Cloudinary en GitHub
• Tutoriales en vídeo

Ejemplo

Para cada tipo de inventario de viajes que admitimos, habrá una matriz JSON anidada denominadamultimediasEl JSON de una entrada multimedia se ve así:

{
  "multimediaIdentifier": "multimedia-1",
  "identifier": "partners/radisson_blu_logo",
  "type": "IMAGE",
  "width": "1024",
  "height": "768",
  "category": "1",
  "descriptions": [
    {
      "name": "Lobby",
      "description": "Picture of the lobby",
      "language": "en"
    }
  ],
  "lifestyleType": "LIFESTYLE_BUSINESS",
  "attribution": [
    {
      "url": "https://www.hilton.com",
      "name": "Hilton"
    }
  ]
}

La línea resaltada arriba muestra el ID único de Cloudinarypartners/radisson_blu_logoEso es todo lo que necesitas para recuperar la imagen en cualquier formato, calidad y tamaño que desees.

Pruebas

Visita nuestraAPIsección y elige la API con la que quieres trabajar.

Documentación de la API

Nuestro sitio de documentación está configurado de tal manera que puede ejecutar comandos API desde el sitio.

En este ejemplo, desea utilizar elSearch Lookups (OAuth2)Llamada API.

:::tip[Consejo profesional] Para facilitar su uso, recomendamos que los integradores utilicen los puntos finales que designamos comoOAuth2Esos puntos finales saben que deben esperar las llamadas de API y ya saben en qué cuenta se encuentra, por lo que no tiene que especificarla.companyIdentifieren tus URL. ::

1. Utilice el API de búsqueda para recuperar destinos u hoteles.
2. En la barra de navegación izquierda, haga clic en Authentication.
3. Ingrese su ID de cliente y secreto de cliente y haga clic en el botón Get TOKEN botón.
4. Si sus credenciales son válidas, verá que se ha aplicado su clave API.
5. Ahora puedes probar el punto final de búsqueda.

Ejemplos de búsquedas (OAuth2)

Cartero

Puedes hacer lo mismo con Postman.

1. Descargar Cartero.
2. Hacer clic en Download OpenAPI spec Desde lo alto de la API de búsqueda página.
3. Importarlo a Postman.
4. Si lo importó como una nueva colección llamada Wink API, haga clic en los puntos suspensivos horizontales (3 puntos) junto al nombre de la colección y haga clic en Edit.
5. En el Authorization tab, establecer el Auth type a OAuth2.
6. Establecer el campo Add auth data to a Request headers.
7. Establecer el campo Header prefix a Bearer.
8. Establecer el campo Token Name Como quieras llamar a tu token guardado en Postman. Por ejemplo, Wink Staging.
9. Establecer el campo Grant type a Client Credentials.
10. Establecer el campo Access token URL a https://staging-iam.wink.travel/oauth2/token.
11. Establecer el campo Client ID al ID de cliente que su aplicación ayudó a generar.
12. Establecer el campo Client Secret al secreto del cliente que su aplicación ayudó a generar.
13. Establecer el campo Scope a inventory.read inventory.write inventory.removeEsos son todos los alcances que necesitarás para Wink.
14. Establecer el campo Client Authentication a Send as Basic Auth header.
15. Haga clic en el Get New Access Token Botón para recuperar tu token y guardarlo.
16. Para todas las llamadas API bajo la colección API Wink, asegúrese de que la pestaña de autenticación diga Inherit auth from parent Por lo tanto, incluye su token con cada llamada.

:::tip[Consejo profesional] Se recomienda convertir el dominio del servidor, el ID del cliente y el secreto del cliente en variables de entorno. De esta forma, podrá cambiar fácilmente entre los entornos de prueba y producción y reutilizar todas las operaciones creadas.