Přeskočit na obsah
Wink

REST a gRPC

Wink nabízí dva transporty. Který použijete, závisí na tom, s jakým API integrujete.

TransportSchémaDokumentace
Většina Wink APIREST přes HTTPSOpenAPI 3Jakákoliv skupina pod API v postranním panelu
Partner Integrator APIgRPC přes HTTP/2Protocol BuffersPartner

Vygenerujte REST klienta

Sekce “Vygenerujte REST klienta”

Každá skupina API publikuje dokument OpenAPI 3. Směřujte na něj jakýkoliv OpenAPI generátor a získáte typovaný klient ve vašem jazyce.

Terminál
# Specifikace pro skupinu je dostupná vedle její referenční stránky.
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

OpenAPI generátory podle jazyka

Vygenerujte gRPC klienta

Sekce “Vygenerujte gRPC klienta”

Partner Integrator API je gRPC. Klienta vygenerujete ze schématu .proto, které Wink publikuje dvěma způsoby:

  • Server reflection — server se popisuje sám, takže nástroje jako grpcurl, Postman a Insomnia mohou schéma objevit za běhu bez nutnosti stahovat soubory. Reflection vyžaduje stejný bearer token jako jakýkoliv jiný požadavek.
  • Soubory .proto, pokud raději chcete schéma mít lokálně a generovat předem.
Terminál
# Objevte schéma z běžícího serveru (autentizováno).
grpcurl -H "authorization: Bearer $WINK_TOKEN" \
  partner.wink.travel:443 list


# Pak vygenerujte klienta — zde Go; každý podporovaný jazyk funguje stejně.
protoc --go_out=. --go-grpc_out=. partner_lookup.proto

Volání nesou váš bearer token v metadatovém hlavičce authorization, stejně jako REST v hlavičce Authorization. Chyby přicházejí jako gRPC status kód v odpovědních trailech místo HTTP status kódu — Partner reference uvádí statusy, které byste měli očekávat.

gRPC rychlé starty podle jazyka

Co je gRPC?

Nebo nechte MCP server napsat kód

Sekce “Nebo nechte MCP server napsat kód”

Pokud používáte AI asistenta pro kódování, náš MCP server je nejrychlejší cesta. Zpřístupňuje Wink API jako nástroje, které váš asistent může volat a analyzovat, takže místo generování celého klienta a hledání endpointů sami, popíšete, co stavíte, a získáte integrační kód přizpůsobený tomu.

Nastavte Wink MCP server

Další čtení

Sekce “Další čtení”