Setup
Questo articolo ti mostrerà come diventare rapidamente uno sviluppatore e iniziare a testare le nostre API su Wink.
I test dovrebbero sempre essere eseguiti nel nostroambiente di stagingCi sono molti meno dati, ma sei libero di effettuare tutti i test che vuoi senza incidere sull’ambiente di produzione.
Una volta che sarai pronto per il lancio, certificheremo il tuo account e la tua applicazione e potrai lanciarli nel nostro ambiente di produzione.
Segui questi passaggi:
- Registro il tuo account utente su Wink
- Crea un conto agente di viaggio o un account affiliato.
- Crea un’applicazione dove lo associ all’account creato nel passaggio 2.
- Una volta creato il tuo
Application
, salva l’ID client e il segreto client in un posto sicuro.
Noi di Wink utilizziamo Cloudinary per tutte le nostre risorse di immagini e video. Accedendo al nostro inventario di viaggi, avrai accesso completo a tutte le funzionalità avanzate di Cloudinary.
Nostro cloud_name
È traveliko
.
Nubinario
Sezione intitolata “Nubinario”Esempio
Sezione intitolata “Esempio”Per ogni tipo di inventario di viaggio che supportiamo, ci sarà un array JSON annidato chiamatomultimedias
Il JSON per una voce multimediale si presenta in questo modo:
{ "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 riga evidenziata sopra mostra l’ID univoco di Cloudinarypartners/radisson_blu_logo
Questo è tutto ciò che ti serve per recuperare l’immagine nel formato, nella qualità e nelle dimensioni che desideri.
Vai direttamente al nostroAPIsezione e scegli l’API con cui vuoi lavorare.
Documentazione API
Sezione intitolata “Documentazione API”Il nostro sito di documentazione è configurato in modo tale da consentire l’esecuzione di comandi API dall’interno del sito.
In questo esempio, si desidera utilizzare ilSearch Lookups (OAuth2)
Chiamata API.
:::tip[Suggerimento Pro]
Per semplicità d’uso, consigliamo agli integratori di utilizzare gli endpoint che designiamo comeOAuth2
Questi endpoint sanno di aspettarsi le chiamate API e sanno già su quale account ti trovi, quindi non devi specificare ilcompanyIdentifier
nei tuoi URL.
::
- Utilizzare il API di ricerca per recuperare destinazioni o hotel.
- Nella barra di navigazione a sinistra, fare clic su
Authentication
. - Inserisci il tuo client-id e il tuo client secret e clicca su
Get TOKEN
pulsante. - Se le tue credenziali sono valide, vedrai che la tua chiave API è stata applicata.
- Ora puoi testare l’endpoint di ricerca.
Postino
Sezione intitolata “Postino”Puoi fare la stessa cosa con Postman.
- Scaricamento Postino.
- Fare clic su
Download OpenAPI spec
dalla cima del API di ricerca pagina. - Importalo in Postman.
- Se l’hai importato come una nuova raccolta chiamata
Wink API
, fare clic sui 3 puntini orizzontali accanto al nome della raccolta e fare clic suEdit
. - Nel
Authorization tab
, impostare ilAuth type
a OAuth2. - Imposta il campo
Add auth data to
ARequest headers
. - Imposta il campo
Header prefix
ABearer
. - Imposta il campo
Token Name
con il nome che vuoi dare al token salvato in Postman. Ad esempio Wink Staging. - Imposta il campo
Grant type
AClient Credentials
. - Imposta il campo
Access token URL
su https://staging-iam.wink.travel/oauth2/token. - Imposta il campo
Client ID
all’ID client che la tua app ha contribuito a generare. - Imposta il campo
Client Secret
al Client Secret che la tua app ha contribuito a generare. - Imposta il campo
Scope
Ainventory.read inventory.write inventory.remove
Questi sono tutti gli ambiti di cui avrai bisogno per Wink. - Imposta il campo
Client Authentication
ASend as Basic Auth header
. - Fare clic su
Get New Access Token
pulsante per recuperare il tuo token e salvarlo. - Per tutte le chiamate API nella raccolta API Wink, assicurati che la scheda di autenticazione indichi
Inherit auth from parent
quindi include il tuo token a ogni chiamata.
:::tip[Suggerimento Pro] Si consiglia di trasformare il dominio del server, l’ID client e il segreto del client in variabili d’ambiente. In questo modo è possibile passare facilmente dall’ambiente di staging a quello di produzione e riutilizzare tutte le operazioni create.