Einrichtung

Dieser Artikel zeigt Ihnen, wie Sie sich schnell als Entwickler einrichten und mit dem Testen unserer APIs auf Wink beginnen.

Folgen Sie diesen Schritten:

Registrieren Sie Ihr Benutzerkonto auf Wink
Erstellen Sie ein Reisebürokonto oder ein Affiliate-Konto.
Erstellen Sie eine Anwendung, die Sie mit dem in Schritt 2 erstellten Konto verknüpfen.
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 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, 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-Secret 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-Endpunkt — *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 horizontale Ellipse (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 das Feld Grant type auf Client Credentials.
Setzen Sie das Feld Access token URL auf https://staging-iam.wink.travel/oauth2/token.
Setzen Sie das Feld Client ID auf die Client-ID, die Ihre App generiert hat.
Setzen Sie das Feld Client Secret auf das Client-Secret, das Ihre App generiert hat.
Setzen Sie das Feld Scope auf inventory.read inventory.write inventory.remove. Das sind alle Berechtigungen, die Sie für Wink benötigen.
Setzen Sie das Feld 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 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.