Configuración

Este artículo te muestra cómo configurarte rápidamente como desarrollador y comenzar a probar nuestras APIs en Wink.

Nota

Las pruebas siempre deben realizarse en nuestro entorno de staging. Hay muchos menos datos allí, pero eres libre de probar todo lo que quieras sin afectar el entorno de producción.

Una vez que estés listo para lanzar en vivo, certificaremos tu cuenta y tu aplicación y podrás lanzar en nuestro entorno de producción.

Sigue estos pasos:

1. Registra tu cuenta de usuario en Wink
2. Crea una cuenta de agente de viajes o una cuenta de afiliado.
3. Crea una Aplicación donde la asocies con la cuenta que creaste en el Paso 2.
4. Una vez que hayas creado tu Application, guarda el client-id y el client secret en un lugar seguro.

CDN

En Wink, usamos Cloudinary para todos nuestros recursos de imágenes y videos. Cuando accedas a nuestro inventario de viajes, tendrás acceso completo a todas las funciones avanzadas de Cloudinary.

Nuestro cloud_name es traveliko.

Cloudinary

• Primeros pasos
• SDKs
• Cloudinary en GitHub
• Tutoriales en video

Ejemplo

Para cada tipo de inventario de viajes que soportamos, habrá un arreglo JSON anidado llamado multimedias. El JSON para 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": "Foto del lobby",
      "language": "en"
    }
  ],
  "lifestyleType": "LIFESTYLE_BUSINESS",
  "attribution": [
    {
      "url": "https://www.hilton.com",
      "name": "Hilton"
    }
  ]
}

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

Pruebas

Dirígete a nuestra sección de APIs 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 puedes ejecutar comandos API desde dentro del sitio.

En este ejemplo, quieres usar la llamada API Search Lookups (OAuth2).

Consejo Profesional

Para facilitar el uso, recomendamos que los integradores usen los endpoints que designamos como OAuth2. Esos endpoints saben que esperan llamadas API y ya saben en qué cuenta estás, por lo que no tienes que especificar el companyIdentifier en tus URLs.

1. Usa la API Lookup para obtener destinos o hoteles.
2. En la barra lateral izquierda, haz clic en Authentication.
3. Ingresa tu client-id y client secret y haz clic en el botón Get TOKEN.
4. Si tus credenciales son válidas, verás que tu clave API ha sido aplicada.
5. Ahora puedes probar el endpoint de lookup.

Ejemplo de Search Lookups (OAuth2)

Postman

Puedes hacer lo mismo con Postman.

1. Descarga Postman.
2. Haz clic en Download OpenAPI spec desde la parte superior de la página de la API Lookup.
3. Impórtalo en Postman.
4. Si lo importaste como una nueva colección llamada Wink API, haz clic en el elipsis horizontal (3 puntos) junto al nombre de la colección y selecciona Edit.
5. En la pestaña Authorization, configura el Auth type a OAuth2.
6. Configura el campo Add auth data to a Request headers.
7. Configura el campo Header prefix a Bearer.
8. Configura el campo Token Name con el nombre que quieras para tu token guardado en Postman. Por ejemplo, Wink Staging.
9. Configura el campo Grant type a Client Credentials.
10. Configura el campo Access token URL a https://staging-iam.wink.travel/oauth2/token.
11. Configura el campo Client ID con el Client ID que tu app ayudó a generar.
12. Configura el campo Client Secret con el Client Secret que tu app ayudó a generar.
13. Configura el campo Scope a inventory.read inventory.write inventory.remove. Esos son todos los scopes que necesitarás para Wink.
14. Configura el campo Client Authentication a Send as Basic Auth header.
15. Haz clic en el botón Get New Access Token para obtener tu token y guardarlo.
16. Para todas las llamadas API bajo la colección Wink API, asegúrate de que la pestaña de autenticación diga Inherit auth from parent para que incluya tu token en cada llamada.

Consejo Profesional

Se recomienda convertir el dominio del servidor, el client ID y el client secret en variables de entorno. De esa manera puedes cambiar fácilmente entre los entornos de staging y producción y reutilizar todas las operaciones que hayas creado.