REST und gRPC

Wink stellt zwei Transportarten bereit. Welche Sie verwenden, hängt davon ab, mit welcher API Sie sich integrieren.

	Transport	Schema	Docs
Die meisten Wink-APIs	REST über HTTPS	OpenAPI 3	Jede Gruppe unter API in der Seitenleiste
Partner Integrator API	gRPC über HTTP/2	Protocol Buffers	Partner

Einen REST-Client generieren

Jede API-Gruppe veröffentlicht ein OpenAPI 3-Dokument. Zeigen Sie einen beliebigen OpenAPI-Generator darauf und Sie erhalten einen typisierten Client in Ihrer Sprache.

# Die Spezifikation jeder Gruppe kann auf dieser Seite heruntergeladen werden: /api/downloads/<group>.json
curl -o wink-extranet.json https://wink.travel/api/downloads/extranet.json

npx @openapitools/openapi-generator-cli generate \
  -i wink-extranet.json -g typescript-fetch -o ./wink-client

OpenAPI-Generatoren nach Sprache

Einen gRPC-Client generieren

Die Partner Integrator API ist gRPC. Sie generieren einen Client aus dem .proto-Schema, das Wink auf zwei Arten bereitstellt:

Server-Reflection — der Server beschreibt sich selbst, sodass Tools wie grpcurl, Postman und Insomnia das Schema zur Laufzeit ohne herunterzuladende Dateien entdecken können. Reflection erfordert denselben Bearer-Token wie jeder andere Aufruf.
Die .proto-Dateien, falls Sie das Schema lieber einbinden und im Voraus generieren möchten.

# Schema von einem laufenden Server entdecken (authentifiziert).
grpcurl -H "authorization: Bearer $WINK_TOKEN" \
  partner.wink.travel:443 list

# Dann einen Client generieren — hier Go; jede unterstützte Sprache funktioniert auf dieselbe Weise.
protoc --go_out=. --go-grpc_out=. partner_lookup.proto

Aufrufe tragen Ihren Bearer-Token im authorization-Metadaten-Header, genau wie REST ihn im Authorization-Header überträgt. Fehler werden als gRPC-Statuscode in den Antwort-Trailern übermittelt, nicht als HTTP-Statuscode — die Partner-Referenz listet die erwartbaren Statuscodes auf.

gRPC Quickstarts nach Sprache

Was ist gRPC?

Oder lassen Sie den MCP-Server den Code schreiben

Wenn Sie einen KI-Coding-Assistenten verwenden, ist unser MCP-Server der schnellste Weg. Er stellt Winks APIs als Werkzeuge bereit, die Ihr Assistent aufrufen und analysieren kann, sodass Sie nicht erst einen kompletten Client generieren und die Endpunkte selbst suchen müssen, sondern einfach beschreiben, was Sie bauen, und Integrationscode erhalten, der darauf zugeschnitten ist.

Den Wink MCP-Server einrichten

Weiterführende Literatur

Setup — Konten, Umgebungen und Zugangsdaten
Authentifizierung — Token erhalten und erneuern
Webhook-Integration — Ereignisse empfangen statt abfragen