Saltar al contingut
Wink

Configuració

Aquest article et mostra com configurar-te ràpidament com a desenvolupador i començar a provar les nostres API a Wink.

Segueix aquests passos:

  1. Registra’t el teu compte d’usuari a Wink.
  2. Crea un compte d’afiliat. Necessitaràs aquest per vincular-hi la teva Aplicació. Consulta què és Studio per a més context.
  3. Crea una Aplicació i associa-la amb el compte d’afiliat que vas crear al Pas 2. Per a integracions API servidor a servidor, tria MACHINE_2_MACHINE com a tipus de client.
  4. Un cop hagis creat la teva Application, copia i desa immediatament el client-id i la clau secreta — la clau secreta només es mostra una vegada i no es pot recuperar.

CDN

Section titled “CDN”

A Wink, utilitzem Cloudinary per a tots els nostres actius d’imatges i vídeos. Quan accedeixis al nostre inventari de viatges, tindràs accés complet a totes les funcions avançades de Cloudinary.

El nostre cloud_name és traveliko.

Cloudinary

Section titled “Cloudinary”

Exemple

Section titled “Exemple”

Per a cada tipus d’inventari de viatges que suportem, hi haurà un array JSON anidat anomenat multimedias. El JSON per a una entrada multimèdia és així:

{
  "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ínia ressaltada mostra l’ID únic de Cloudinary partners/radisson_blu_logo. Això és tot el que necessites per recuperar la imatge en qualsevol format, qualitat i mida que vulguis.

Proves

Section titled “Proves”

Ves a la nostra secció d’APIs i tria l’API amb la qual vols treballar.

Documentació de l’API

Section titled “Documentació de l’API”

El nostre lloc de documentació està configurat de manera que pots executar comandes API des del mateix lloc.

En aquest exemple, vols utilitzar la crida API Search Lookups (OAuth2).

  1. Utilitza la Lookup API per recuperar destinacions o hotels.
  2. A la barra de navegació esquerra, fes clic a Authentication.
  3. Introdueix el teu client-id i client secret i fes clic al botó Get TOKEN.
  4. Si les teves credencials són vàlides, veuràs que la teva clau API s’ha aplicat.
  5. Ara pots provar l’endpoint de lookup.
Endpoint de Lookup API
Exemple de Search Lookups (OAuth2)

Postman

Section titled “Postman”

Pots fer el mateix amb Postman.

  1. Descarrega Postman.
  2. Fes clic a Download OpenAPI spec a la part superior de la pàgina de la Lookup API.
  3. Importa-ho a Postman.
  4. Si l’has importat com una nova col·lecció anomenada Wink API, fes clic a l’el·lipse horitzontal (3 punts) al costat del nom de la col·lecció i fes clic a Edit.
  5. A la pestanya Authorization, configura el Auth type a OAuth2.
  6. Configura el camp Add auth data to a Request headers.
  7. Configura el camp Header prefix a Bearer.
  8. Configura el camp Token Name amb el nom que vulguis per al teu token desat a Postman. Per exemple, Wink Staging.
  9. Configura el camp Grant type a Client Credentials.
  10. Configura el camp Access token URL a https://staging-iam.wink.travel/oauth2/token.
  11. Configura el camp Client ID amb el Client ID que la teva app ha generat.
  12. Configura el camp Client Secret amb el Client Secret que la teva app ha generat.
  13. Configura el camp Scope a inventory.read inventory.write inventory.remove. Aquests són tots els àmbits que necessitaràs per a Wink.
  14. Configura el camp Client Authentication a Send as Basic Auth header.
  15. Fes clic al botó Get New Access Token per obtenir el teu token i desa’l.
  16. Per a totes les crides API sota la col·lecció Wink API, assegura’t que la pestanya d’autenticació digui Inherit auth from parent perquè inclogui el teu token en cada crida.