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:
- Registra’t el vostre compte d’usuari a Wink
- Crea un compte d’agent de viatges o un compte d’afiliat.
- Crea una aplicació on l’associeu amb el compte que heu creat al pas 2.
- Un cop hàgiu creat el vostre
Application
, deseu l’ID del client i el secret del client en un lloc segur.
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
Section titled “Nuvolositat”Exemple
Section titled “Exemple”Per a cada tipus d’inventari de viatges que admetem, hi haurà una matriu JSON imbricada anomenadamultimedias
El 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_logo
Això és tot el que necessiteu per recuperar la imatge en qualsevol format, qualitat i mida que vulgueu.
Proves
Section titled “Proves”Dirigiu-vos al nostreAPIsecció i trieu l’API amb què voleu treballar.
Documentació de l’API
Section titled “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 aOAuth2
Aquests punts finals saben que esperen trucades de l’API i ja saben en quin compte esteu, de manera que no cal especificar-ho.companyIdentifier
a les vostres URL.
:::
- Utilitzeu el API de cerca per recuperar destinacions o hotels.
- A la barra de navegació esquerra, feu clic a
Authentication
. - Introduïu el vostre ID de client i el secret del client i feu clic a
Get TOKEN
botó. - Si les teves credencials són vàlides, veuràs que s’ha aplicat la teva clau API.
- Ara podeu provar el punt final de cerca.
Carter
Section titled “Carter”Pots fer el mateix amb el carter.
- Descarrega Carter.
- Feu clic a
Download OpenAPI spec
des de dalt de la API de cerca pàgina. - Importa-ho a Postman.
- 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 aEdit
. - En el
Authorization tab
, estableix elAuth type
a OAuth2. - Defineix el camp
Add auth data to
aRequest headers
. - Defineix el camp
Header prefix
aBearer
. - Defineix el camp
Token Name
al nom que vulgueu donar al vostre token desat a Postman. P. ex. Wink Staging. - Defineix el camp
Grant type
aClient Credentials
. - Defineix el camp
Access token URL
a https://staging-iam.wink.travel/oauth2/token. - Defineix el camp
Client ID
a l’ID de client que la teva aplicació ha ajudat a generar. - Defineix el camp
Client Secret
al secret del client que la teva aplicació ha ajudat a generar. - Defineix el camp
Scope
ainventory.read inventory.write inventory.remove
Aquests són tots els visors que necessitaràs per a Wink. - Defineix el camp
Client Authentication
aSend as Basic Auth header
. - Feu clic a
Get New Access Token
botó per recuperar el vostre token i desar-lo. - 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. :::