Setup

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

Les proves sempre s’han de fer a la nostraentorn de posada en escenaHi ha moltes menys dades, però ets lliure de provar tant com vulguis sense imposar-ho a l’entorn de producció.

Un cop estigueu a punt per llançar-lo, certificarem el vostre compte i la vostra aplicació i podreu llançar-lo al nostre entorn de producció.

Segueix aquests passos:

1. Registra’t el vostre compte d’usuari a Wink
2. Crea un compte d’agent de viatges o un compte d’afiliat.
3. Crea una aplicació on l’associeu amb el compte que heu creat al pas 2.
4. Un cop hàgiu creat el vostre Application, deseu l’ID del client i el secret del client en un lloc segur.

CDN

A Wink, fem servir Cloudinary per a tots els nostres recursos 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 nostrecloud_nameéstraveliko.

Nuvolositat

• Primers passos
• SDK
• Cloudinary a GitHub
• Tutorials en vídeo

Exemple

Per a cada tipus d’inventari de viatges que admetem, hi haurà una matriu JSON imbricada anomenadamultimediasEl JSON per a una entrada multimèdia té aquest aspecte:

{
  "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 a sobre mostra l’identificador únic de Cloudinary.partners/radisson_blu_logoAixò és tot el que necessiteu per recuperar la imatge en qualsevol format, qualitat i mida que vulgueu.

Proves

Dirigiu-vos al nostreAPIsecció i trieu l’API amb què voleu treballar.

Documentació de l’API

El nostre lloc de documentació està configurat de manera que podeu executar ordres de l’API des de dins del lloc.

En aquest exemple, voleu utilitzar elSearch Lookups (OAuth2)Crida a l’API.

:::tip[Consell professional] Per facilitar-ne l’ús, recomanem que els integradors utilitzin els punts finals que designem com aOAuth2Aquests punts finals saben que esperen trucades de l’API i ja saben en quin compte esteu, de manera que no cal especificar-ho.companyIdentifiera les vostres URL. :::

1. Utilitzeu el API de cerca per recuperar destinacions o hotels.
2. A la barra de navegació esquerra, feu clic a Authentication.
3. Introduïu el vostre ID de client i el secret del client i feu clic a Get TOKEN botó.
4. Si les teves credencials són vàlides, veuràs que s’ha aplicat la teva clau API.
5. Ara podeu provar el punt final de cerca.

Exemples de cerques de cerca (OAuth2)

Carter

Pots fer el mateix amb el carter.

1. Descarrega Carter.
2. Feu clic a Download OpenAPI spec des de dalt de la API de cerca pàgina.
3. Importa-ho a Postman.
4. Si l’heu importat com una nova col·lecció anomenada Wink API, feu clic a l’elipsi horitzontal (3 punts) que hi ha al costat del nom de la col·lecció i feu clic a Edit.
5. En el Authorization tab, estableix el Auth type a OAuth2.
6. Defineix el camp Add auth data to a Request headers.
7. Defineix el camp Header prefix a Bearer.
8. Defineix el camp Token Name al nom que vulgueu donar al vostre token desat a Postman. P. ex. Wink Staging.
9. Defineix el camp Grant type a Client Credentials.
10. Defineix el camp Access token URL a https://staging-iam.wink.travel/oauth2/token.
11. Defineix el camp Client ID a l’ID de client que la teva aplicació ha ajudat a generar.
12. Defineix el camp Client Secret al secret del client que la teva aplicació ha ajudat a generar.
13. Defineix el camp Scope a inventory.read inventory.write inventory.removeAquests són tots els visors que necessitaràs per a Wink.
14. Defineix el camp Client Authentication a Send as Basic Auth header.
15. Feu clic a Get New Access Token botó per recuperar el vostre token i desar-lo.
16. Per a totes les crides a l’API de la col·lecció d’API de Wink, assegureu-vos que la pestanya d’autenticació digui Inherit auth from parent de manera que inclou el teu token amb cada trucada.

:::tip[Consell professional] Es recomana convertir el domini del servidor, l’ID del client i el secret del client en variables d’entorn. D’aquesta manera, podeu canviar fàcilment entre entorns de proves i de producció i reutilitzar totes les operacions que heu creat. :::