Einrichtung

Dieser Artikel zeigt Ihnen, wie Sie sich schnell als Entwickler einrichten und unsere APIs auf Wink testen können.

Hinweis

Tests sollten immer in unserer Staging-Umgebung durchgeführt werden. Dort gibt es deutlich weniger Daten, aber Sie können so viel testen, wie Sie möchten, ohne die Produktionsumgebung zu belasten.

Sobald Sie bereit sind, live zu gehen, zertifizieren wir Ihr Konto und Ihre Anwendung, und Sie können in unserer Produktionsumgebung starten.

Folgen Sie diesen Schritten:

1. Registrieren Sie Ihr Benutzerkonto auf Wink
2. Erstellen Sie ein Reisebürokonto oder ein Affiliate-Konto.
3. Erstellen Sie eine Anwendung, die Sie mit dem in Schritt 2 erstellten Konto verknüpfen.
4. Sobald Sie Ihre Application erstellt haben, speichern Sie die Client-ID und das Client-Secret an einem sicheren Ort.

CDN

Bei Wink verwenden wir Cloudinary für alle unsere Bild- und Videoassets. Wenn Sie auf unser Reiseinventar zugreifen, haben Sie vollen Zugriff auf alle fortschrittlichen 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 namens multimedias. Das JSON für einen Multimedia-Eintrag sieht so aus:

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

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

Testen

Gehen Sie zu unserem APIs-Bereich und wählen Sie die API aus, mit der Sie arbeiten möchten.

API-Dokumentation

Unsere Dokumentationsseite ist so eingerichtet, dass Sie API-Befehle direkt auf der Seite ausführen können.

In diesem Beispiel möchten Sie den API-Aufruf Search Lookups (OAuth2) verwenden.

Profi-Tipp

Zur einfacheren Nutzung empfehlen wir Integratoren, die Endpunkte zu verwenden, die wir als OAuth2 kennzeichnen. Diese Endpunkte erwarten API-Aufrufer und wissen bereits, bei welchem Konto Sie angemeldet sind, sodass Sie die companyIdentifier nicht in Ihren URLs angeben müssen.

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-Secret ein und klicken Sie auf die Schaltfläche Get TOKEN.
4. Wenn Ihre Anmeldedaten gültig sind, sehen Sie, dass Ihr API-Schlüssel angewendet wurde.
5. Sie können nun den Lookup-Endpunkt testen.

Beispiel Search Lookups (OAuth2)

Postman

Sie können dasselbe mit Postman machen.

1. Laden Sie Postman herunter.
2. Klicken Sie oben auf der Lookup API-Seite auf Download OpenAPI spec.
3. Importieren Sie diese in Postman.
4. Wenn Sie sie als neue Sammlung namens Wink API importiert haben, klicken Sie auf die horizontalen Auslassungspunkte (3 Punkte) neben dem Sammlungsnamen und wählen Sie Edit.
5. Stellen Sie im Tab Authorization den Auth type auf OAuth2 ein.
6. Setzen Sie das Feld Add auth data to auf Request headers.
7. Setzen Sie das Feld Header prefix auf Bearer.
8. Benennen Sie im Feld Token Name Ihren gespeicherten Token in Postman, z. B. Wink Staging.
9. Setzen Sie den Grant type auf Client Credentials.
10. Setzen Sie die Access token URL auf https://staging-iam.wink.travel/oauth2/token.
11. Geben Sie die Client-ID ein, die Ihre App generiert hat.
12. Geben Sie das Client-Secret ein, das Ihre App generiert hat.
13. Setzen Sie den Scope auf inventory.read inventory.write inventory.remove. Das sind alle Berechtigungen, die Sie für Wink benötigen.
14. Setzen Sie die Client Authentication auf Send as Basic Auth header.
15. Klicken Sie auf die Schaltfläche Get New Access Token, um Ihren Token abzurufen und zu speichern.
16. Stellen Sie bei allen API-Aufrufen unter der Wink API-Sammlung sicher, dass im Authentifizierungs-Tab Inherit auth from parent ausgewählt ist, damit Ihr Token bei jedem Aufruf mitgesendet wird.

Profi-Tipp

Es wird empfohlen, die Server-Domain, Client-ID und das Client-Secret als Umgebungsvariablen zu speichern. So können Sie einfach zwischen Staging- und Produktionsumgebungen wechseln und alle erstellten Operationen wiederverwenden.