REST et gRPC

Wink propose deux types de transport. Celui que vous utilisez dépend de l’API avec laquelle vous vous intégrez.

	Transport	Schéma	Docs
La plupart des APIs Wink	REST via HTTPS	OpenAPI 3	Tout groupe sous API dans la barre latérale
Partner Integrator API	gRPC via HTTP/2	Protocol Buffers	Partner

Générer un client REST

Chaque groupe d’API publie un document OpenAPI 3. Pointez n’importe quel générateur OpenAPI dessus et vous obtenez un client typé dans votre langage.

# La spécification pour un groupe est servie à côté de sa page de référence.
curl -o wink-extranet.json https://api.wink.travel/v3/api-docs/extranet

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

Générateurs OpenAPI par langage

Générer un client gRPC

Le Partner Integrator API est en gRPC. Vous générez un client à partir du schéma .proto, que Wink publie de deux façons :

Réflexion serveur — le serveur se décrit lui-même, ainsi des outils comme grpcurl, Postman et Insomnia peuvent découvrir le schéma à l’exécution sans fichiers à télécharger. La réflexion nécessite le même jeton bearer que pour tout autre appel.
Les fichiers .proto, si vous préférez intégrer le schéma et générer à l’avance.

# Découvrir le schéma depuis un serveur en fonctionnement (authentifié).
grpcurl -H "authorization: Bearer $WINK_TOKEN" \
  partner.wink.travel:443 list

# Puis générer un client — ici Go ; chaque langage supporté fonctionne de la même manière.
protoc --go_out=. --go-grpc_out=. partner_lookup.proto

Les appels portent votre jeton bearer dans l’en-tête metadata authorization, exactement comme REST le porte dans l’en-tête Authorization. Les erreurs arrivent sous forme d’un code de statut gRPC dans les trailers de la réponse plutôt que sous forme d’un code HTTP — la référence Partner liste les statuts que vous devez attendre.

Démarrages rapides gRPC par langage

Qu’est-ce que gRPC ?

Ou laissez le serveur MCP l’écrire

Si vous utilisez un assistant de codage IA, notre serveur MCP est la voie la plus rapide. Il expose les APIs Wink comme des outils que votre assistant peut appeler et analyser, ainsi au lieu de générer un client complet et de chercher les endpoints vous-même, vous décrivez ce que vous construisez et obtenez du code d’intégration adapté.

Configurez le serveur MCP Wink

Lectures complémentaires

Configuration — comptes, environnements et identifiants
Authentification — obtention et renouvellement des jetons
Intégration Webhook — recevoir des événements au lieu de faire du polling