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:
- Registrieren Ihr Benutzerkonto bei Wink
- Erstellen Sie ein Reisebüro-Konto oder ein Partnerkonto.
- Erstellen einer Anwendung wo Sie es mit dem Konto verknüpfen, das Sie in Schritt 2 erstellt haben.
- Sobald Sie Ihre
Application
, speichern Sie die Client-ID und das Client-Geheimnis an einem sicheren Ort.
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
Abschnitt betitelt „Cloudinary“Beispiel
Abschnitt betitelt „Beispiel“Für jeden von uns unterstützten Reiseinventartyp gibt es ein verschachteltes JSON-Array namensmultimedias
Das 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.
Besuchen Sie unsereAPIsund wählen Sie die API aus, mit der Sie arbeiten möchten.
API-Dokumente
Abschnitt betitelt „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 diecompanyIdentifier
in Ihren URLs.
::
- 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
Get TOKEN
Taste. - Wenn Ihre Anmeldeinformationen gültig sind, sehen Sie, dass Ihr API-Schlüssel angewendet wurde.
- Sie können jetzt den Lookup-Endpunkt testen.
Briefträger
Abschnitt betitelt „Briefträger“Dasselbe können Sie mit Postman tun.
- Herunterladen Briefträger.
- Klicken Sie auf
Download OpenAPI spec
von der Spitze des Lookup-API Seite. - Importieren Sie es in Postman.
- 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 aufEdit
. - Im
Authorization tab
, legen Sie dieAuth type
zu OAuth2. - Legen Sie das Feld fest
Add auth data to
ZuRequest headers
. - Legen Sie das Feld fest
Header prefix
ZuBearer
. - Legen Sie das Feld fest
Token Name
Geben Sie Ihrem gespeicherten Token in Postman den gewünschten Namen. Z. B. Wink Staging. - Legen Sie das Feld fest
Grant type
ZuClient Credentials
. - Legen Sie das Feld fest
Access token URL
zu https://staging-iam.wink.travel/oauth2/token. - Legen Sie das Feld fest
Client ID
zur Client-ID, die Ihre App generiert hat. - Legen Sie das Feld fest
Client Secret
zum Client Secret, das Ihre App generiert hat. - Legen Sie das Feld fest
Scope
Zuinventory.read inventory.write inventory.remove
. Dies sind alle Bereiche, die Sie für Wink benötigen. - Legen Sie das Feld fest
Client Authentication
ZuSend as Basic Auth header
. - Klicken Sie auf das
Get New Access Token
Schaltfläche, um Ihr Token abzurufen und zu speichern. - 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.