Preskočiť na obsah
Wink

REST a gRPC

Wink poskytuje dva transporty. Ktorý použijete, závisí od toho, s ktorým API sa integrujete.

TransportSchémaDokumentácia
Väčšina Wink APIREST cez HTTPSOpenAPI 3Akákoľvek skupina pod API v bočnom paneli
Partner Integrator APIgRPC cez HTTP/2Protocol BuffersPartner

Vygenerujte REST klienta

Section titled “Vygenerujte REST klienta”

Každá skupina API publikuje dokument OpenAPI 3. Nasmerujte naň akýkoľvek OpenAPI generátor a získate typovaného klienta vo vašom jazyku.

Terminal window
# Špecifikácia každej skupiny je na stiahnutie na tejto stránke: /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 generátory podľa jazyka

Vygenerujte gRPC klienta

Section titled “Vygenerujte gRPC klienta”

Partner Integrator API je gRPC. Klienta vygenerujete zo schémy .proto, ktorú Wink publikuje dvoma spôsobmi:

  • Server reflection — server sa sám popisuje, takže nástroje ako grpcurl, Postman a Insomnia môžu počas behu objaviť schému bez potreby sťahovať súbory. Reflection vyžaduje rovnaký bearer token ako ktorýkoľvek iný volanie.
  • Súbory .proto, ak radšej chcete mať schému lokálne a generovať vopred.
Terminal window
# Objavte schému z bežiaceho servera (autentifikované).
grpcurl -H "authorization: Bearer $WINK_TOKEN" \
  partner.wink.travel:443 list


# Potom vygenerujte klienta — tu Go; každý podporovaný jazyk funguje rovnako.
protoc --go_out=. --go-grpc_out=. partner_lookup.proto

Volania nesú váš bearer token v metadátovom hlavičke authorization, presne ako REST v hlavičke Authorization. Chyby prichádzajú ako gRPC status kód v odpovedných traileroch namiesto HTTP status kódu — Partner referenčný manuál uvádza statusy, ktoré môžete očakávať.

gRPC rýchle štarty podľa jazyka

Čo je gRPC?

Alebo nechajte MCP server, nech to napíše

Section titled “Alebo nechajte MCP server, nech to napíše”

Ak používate AI asistenta na kódovanie, náš MCP server je najrýchlejšia cesta. Poskytuje Wink API ako nástroje, ktoré váš asistent môže volať a analyzovať, takže namiesto generovania celého klienta a hľadania endpointov sami, popíšete, čo budujete, a dostanete integračný kód prispôsobený tomu.

Nastavte Wink MCP server

Ďalšie čítanie

Section titled “Ďalšie čítanie”