Setup

In diesem Artikel erfahren Sie, wie Sie sich schnell als Entwickler einrichten und mit dem Testen unserer APIs auf Wink beginnen.

Tests sollten immer in unseremStaging-Umgebung. Dort sind zwar viel weniger Daten vorhanden, aber Sie können so viel testen, wie Sie möchten, ohne die Produktionsumgebung zu beeinträchtigen.

Sobald Sie bereit für den Live-Einsatz sind, zertifizieren wir Ihr Konto und Ihre Anwendung und Sie können in unserer Produktionsumgebung starten. ::

Gehen Sie folgendermaßen vor:

1. Registrieren Ihr Benutzerkonto bei Wink
2. Erstellen Sie ein Reisebüro-Konto oder ein Partnerkonto.
3. Erstellen einer Anwendung wo Sie es mit dem Konto verknüpfen, das Sie in Schritt 2 erstellt haben.
4. Sobald Sie Ihre Application, speichern Sie die Client-ID und das Client-Geheimnis an einem sicheren Ort.

CDN

Bei Wink nutzen wir Cloudinary für alle unsere Bild- und Videoinhalte. Wenn Sie auf unser Reiseinventar zugreifen, haben Sie vollen Zugriff auf alle erweiterten Funktionen von Cloudinary.

Unser cloud_name Ist traveliko.

Cloudinary

• Erste Schritte
• SDKs
• Cloudinary auf GitHub
• Video-Tutorials

Beispiel

Für jeden von uns unterstützten Reiseinventartyp gibt es ein verschachteltes JSON-Array namensmultimediasDas JSON für einen Multimediaeintrag sieht folgendermaßen aus:

{
  "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"
    }
  ]
}

Die hervorgehobene Zeile oben zeigt die eindeutige ID von Cloudinarypartners/radisson_blu_logo. Das ist alles, was Sie brauchen, um das Bild in jedem gewünschten Format, jeder gewünschten Qualität und Größe abzurufen.

Testen

Besuchen Sie unsereAPIsund wählen Sie die API aus, mit der Sie arbeiten möchten.

API-Dokumente

Unsere Dokumentationssite ist so eingerichtet, dass Sie API-Befehle innerhalb der Site ausführen können.

In diesem Beispiel möchten Sie dieSearch Lookups (OAuth2)API-Aufruf.

:::tip[Profi-Tipp] Aus Gründen der Benutzerfreundlichkeit empfehlen wir Integratoren die Verwendung der von uns alsOAuth2. Diese Endpunkte wissen, dass sie API-Aufrufer erwarten und wissen bereits, welches Konto Sie verwenden, sodass Sie diecompanyIdentifierin Ihren URLs. ::

1. Verwenden Sie die Lookup-API um Reiseziele oder Hotels abzurufen.
2. Klicken Sie in der linken Navigationsleiste auf Authentication.
3. Geben Sie Ihre Client-ID und Ihr Client-Geheimnis ein und klicken Sie auf Get TOKEN Taste.
4. Wenn Ihre Anmeldeinformationen gültig sind, sehen Sie, dass Ihr API-Schlüssel angewendet wurde.
5. Sie können jetzt den Lookup-Endpunkt testen.

Beispielsuchvorgänge (OAuth2)

Briefträger

Dasselbe können Sie mit Postman tun.

1. Herunterladen Briefträger.
2. Klicken Sie auf Download OpenAPI spec von der Spitze des Lookup-API Seite.
3. Importieren Sie es in Postman.
4. Wenn Sie es als neue Sammlung mit dem Namen importiert haben Wink API, klicken Sie auf die horizontalen Auslassungspunkte (3 Punkte) neben dem Sammlungsnamen und klicken Sie auf Edit.
5. Im Authorization tab, legen Sie die Auth type zu OAuth2.
6. Legen Sie das Feld fest Add auth data to Zu Request headers.
7. Legen Sie das Feld fest Header prefix Zu Bearer.
8. Legen Sie das Feld fest Token Name Geben Sie Ihrem gespeicherten Token in Postman den gewünschten Namen. Z. B. Wink Staging.
9. Legen Sie das Feld fest Grant type Zu Client Credentials.
10. Legen Sie das Feld fest Access token URL zu https://staging-iam.wink.travel/oauth2/token.
11. Legen Sie das Feld fest Client ID zur Client-ID, die Ihre App generiert hat.
12. Legen Sie das Feld fest Client Secret zum Client Secret, das Ihre App generiert hat.
13. Legen Sie das Feld fest Scope Zu inventory.read inventory.write inventory.remove. Dies sind alle Bereiche, die Sie für Wink benötigen.
14. Legen Sie das Feld fest Client Authentication Zu Send as Basic Auth header.
15. Klicken Sie auf das Get New Access Token Schaltfläche, um Ihr Token abzurufen und zu speichern.
16. Stellen Sie für alle API-Aufrufe unter der Wink-API-Sammlung sicher, dass auf der Registerkarte „Authentifizierung“ steht: Inherit auth from parent Ihr Token ist also bei jedem Anruf enthalten.

:::tip[Profi-Tipp] Es wird empfohlen, Serverdomäne, Client-ID und Client-Geheimnis in Umgebungsvariablen zu speichern. So können Sie problemlos zwischen Staging- und Produktionsumgebungen wechseln und alle erstellten Operationen wiederverwenden.