Einrichtung

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

Folgen Sie diesen Schritten:

Registrieren Sie Ihr Benutzerkonto auf Wink.
Erstellen Sie ein Affiliate-Konto. Dieses benötigen Sie, um Ihre Anwendung daran zu binden. Weitere Informationen finden Sie unter Was ist Studio.
Erstellen Sie eine Anwendung und verknüpfen Sie sie mit dem Affiliate-Konto, das Sie in Schritt 2 erstellt haben. Für Server-zu-Server-API-Integrationen wählen Sie MACHINE_2_MACHINE als Client-Typ.
Sobald Sie Ihre Application erstellt haben, kopieren und speichern Sie sofort die Client-ID und den geheimen Schlüssel — der geheime Schlüssel wird nur einmal angezeigt und kann nicht erneut abgerufen werden.

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 erweiterten Funktionen von Cloudinary.

Unser cloud_name ist traveliko.

Cloudinary

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 eindeutige Cloudinary-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 von der Seite aus ausführen können.

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

Verwenden Sie die Lookup API, um Reiseziele oder Hotels abzurufen.
Klicken Sie in der linken Navigationsleiste auf Authentication.
Geben Sie Ihre Client-ID und Ihr Client-Geheimnis ein und klicken Sie auf die Schaltfläche Get TOKEN.
Wenn Ihre Anmeldedaten gültig sind, sehen Sie, dass Ihr API-Schlüssel angewendet wurde.
Sie können nun den Lookup-Endpunkt testen.

Lookup API endpoint — *Beispiel Search Lookups (OAuth2)*

Postman

Sie können dasselbe mit Postman machen.

Laden Sie Postman herunter.
Klicken Sie oben auf der Lookup API Seite auf Download OpenAPI spec.
Importieren Sie diese in Postman.
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.
Stellen Sie im Tab Authorization den Auth type auf OAuth2 ein.
Setzen Sie das Feld Add auth data to auf Request headers.
Setzen Sie das Feld Header prefix auf Bearer.
Benennen Sie das Feld Token Name nach Belieben, z. B. Wink Staging.
Setzen Sie den Grant type auf Client Credentials.
Setzen Sie die Access token URL auf https://staging-iam.wink.travel/oauth2/token.
Geben Sie die Client-ID ein, die Ihre App generiert hat.
Geben Sie das Client-Geheimnis ein, das Ihre App generiert hat.
Setzen Sie das Feld Scope auf die durch Leerzeichen getrennten Berechtigungen, die Ihre Integration benötigt (z. B. inventory.read inventory.write inventory.remove). Die vollständige Liste finden Sie in der Scope-Referenz.
Setzen Sie die Client Authentication auf Send as Basic Auth header.
Klicken Sie auf die Schaltfläche Get New Access Token, um Ihr Token abzurufen und zu speichern.
Stellen Sie bei allen API-Aufrufen in der Wink API-Sammlung sicher, dass im Authentifizierungs-Tab Inherit auth from parent ausgewählt ist, damit Ihr Token bei jedem Aufruf mitgesendet wird.