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:
- Registro tu cuenta de usuario en Wink
- Crear una cuenta de agente de viajes o un cuenta de afiliado.
- Crear una aplicación donde lo asocias con la cuenta que creaste en el Paso 2.
- Una vez que hayas creado tu
Application
, guarde el ID del cliente y el secreto del cliente en un lugar seguro.
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
Sección titulada «Nublado»Ejemplo
Sección titulada «Ejemplo»Para cada tipo de inventario de viajes que admitimos, habrá una matriz JSON anidada denominadamultimedias
El 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_logo
Eso es todo lo que necesitas para recuperar la imagen en cualquier formato, calidad y tamaño que desees.
Pruebas
Sección titulada «Pruebas»Visita nuestraAPIsección y elige la API con la que quieres trabajar.
Documentación de la API
Sección titulada «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 comoOAuth2
Esos 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.companyIdentifier
en tus URL.
::
- Utilice el API de búsqueda para recuperar destinos u hoteles.
- En la barra de navegación izquierda, haga clic en
Authentication
. - Ingrese su ID de cliente y secreto de cliente y haga clic en el botón
Get TOKEN
botón. - Si sus credenciales son válidas, verá que se ha aplicado su clave API.
- Ahora puedes probar el punto final de búsqueda.
Cartero
Sección titulada «Cartero»Puedes hacer lo mismo con Postman.
- Descargar Cartero.
- Hacer clic en
Download OpenAPI spec
Desde lo alto de la API de búsqueda página. - Importarlo a Postman.
- 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 enEdit
. - En el
Authorization tab
, establecer elAuth type
a OAuth2. - Establecer el campo
Add auth data to
aRequest headers
. - Establecer el campo
Header prefix
aBearer
. - Establecer el campo
Token Name
Como quieras llamar a tu token guardado en Postman. Por ejemplo, Wink Staging. - Establecer el campo
Grant type
aClient Credentials
. - Establecer el campo
Access token URL
a https://staging-iam.wink.travel/oauth2/token. - Establecer el campo
Client ID
al ID de cliente que su aplicación ayudó a generar. - Establecer el campo
Client Secret
al secreto del cliente que su aplicación ayudó a generar. - Establecer el campo
Scope
ainventory.read inventory.write inventory.remove
Esos son todos los alcances que necesitarás para Wink. - Establecer el campo
Client Authentication
aSend as Basic Auth header
. - Haga clic en el
Get New Access Token
Botón para recuperar tu token y guardarlo. - 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.