Configurazione

Questo articolo ti mostra come configurarti rapidamente come sviluppatore e iniziare a testare le nostre API su Wink.

Nota

I test devono sempre essere effettuati nel nostro ambiente di staging. Ci sono molti meno dati, ma sei libero di testare quanto vuoi senza influire sull’ambiente di produzione.

Quando sei pronto per andare in produzione, certificheremo il tuo account e la tua applicazione e potrai lanciare nell’ambiente di produzione.

Segui questi passaggi:

1. Registrati con il tuo account utente su Wink
2. Crea un account agente di viaggio o un account affiliato.
3. Crea un’Applicazione associandola all’account creato al Passo 2.
4. Una volta creata la tua Application, conserva in un luogo sicuro il client-id e il client secret.

CDN

Su Wink, utilizziamo Cloudinary per tutti i nostri asset di immagini e video. Quando accedi al nostro inventario di viaggi, avrai pieno accesso a tutte le funzionalità avanzate di Cloudinary.

Il nostro cloud_name è traveliko.

Cloudinary

• Per iniziare
• SDK
• Cloudinary su GitHub
• Video Tutorial

Esempio

Per ogni tipo di inventario di viaggio che supportiamo, ci sarà un array JSON annidato chiamato multimedias. Il JSON per una voce multimediale è simile a questo:

{
  "multimediaIdentifier": "multimedia-1",
  "identifier": "partners/radisson_blu_logo",
  "type": "IMAGE",
  "width": "1024",
  "height": "768",
  "category": "1",
  "descriptions": [
    {
      "name": "Lobby",
      "description": "Foto della hall",
      "language": "en"
    }
  ],
  "lifestyleType": "LIFESTYLE_BUSINESS",
  "attribution": [
    {
      "url": "https://www.hilton.com",
      "name": "Hilton"
    }
  ]
}

La riga evidenziata sopra mostra l’ID univoco Cloudinary partners/radisson_blu_logo. È tutto ciò di cui hai bisogno per recuperare l’immagine in qualsiasi formato, qualità e dimensione desideri.

Test

Vai alla nostra sezione API e scegli l’API con cui vuoi lavorare.

Documentazione API

Il nostro sito di documentazione è strutturato in modo che tu possa eseguire comandi API direttamente dal sito.

In questo esempio, vuoi usare la chiamata API Search Lookups (OAuth2).

Consiglio Professionale

Per facilità d’uso, consigliamo agli integratori di utilizzare gli endpoint che designiamo come OAuth2. Quegli endpoint sanno già di aspettarsi chiamate API e conoscono già a quale account sei associato, quindi non devi specificare il companyIdentifier nelle tue URL.

1. Usa la Lookup API per recuperare destinazioni o hotel.
2. Nella barra di navigazione a sinistra, clicca su Authentication.
3. Inserisci il tuo client-id e client secret e clicca sul pulsante Get TOKEN.
4. Se le tue credenziali sono valide, vedrai che la tua chiave API è stata applicata.
5. Ora puoi testare l’endpoint lookup.

Esempio di Search Lookups (OAuth2)

Postman

Puoi fare la stessa cosa con Postman.

1. Scarica Postman.
2. Clicca su Download OpenAPI spec in cima alla pagina della Lookup API.
3. Importalo in Postman.
4. Se lo hai importato come nuova collezione chiamata Wink API, clicca sui tre puntini orizzontali accanto al nome della collezione e seleziona Edit.
5. Nella scheda Authorization, imposta il Auth type su OAuth2.
6. Imposta il campo Add auth data to su Request headers.
7. Imposta il campo Header prefix su Bearer.
8. Imposta il campo Token Name con il nome che vuoi dare al token salvato in Postman, ad esempio Wink Staging.
9. Imposta il campo Grant type su Client Credentials.
10. Imposta il campo Access token URL su https://staging-iam.wink.travel/oauth2/token.
11. Imposta il campo Client ID con il Client ID generato dalla tua app.
12. Imposta il campo Client Secret con il Client Secret generato dalla tua app.
13. Imposta il campo Scope su inventory.read inventory.write inventory.remove. Questi sono tutti gli scope necessari per Wink.
14. Imposta il campo Client Authentication su Send as Basic Auth header.
15. Clicca sul pulsante Get New Access Token per recuperare il token e salvarlo.
16. Per tutte le chiamate API nella collezione Wink API, assicurati che la scheda di autenticazione dica Inherit auth from parent in modo che includa il token in ogni chiamata.

Consiglio Professionale

Si consiglia di trasformare il dominio del server, il client ID e il client secret in variabili d’ambiente. In questo modo puoi facilmente passare tra gli ambienti di staging e produzione e riutilizzare tutte le operazioni che hai creato.