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 vydává dokument OpenAPI 3. Směřujte na něj jakýkoliv OpenAPI generátor a získáte typovaného klienta ve vašem jazyce.

Terminál
# Specifikace každé skupiny je ke stažení na tomto webu: /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 podle jazyka

Vygenerujte gRPC klienta

Sekce “Vygenerujte gRPC klienta”

Partner Integrator API je gRPC. Klienta vygenerujete ze schématu .proto, které Wink zveřejňuje dvěma způsoby:

  • Server reflection — server se popisuje sám, takže nástroje jako grpcurl, Postman a Insomnia mohou za běhu objevit schéma bez nutnosti stahovat soubory. Reflection vyžaduje stejný bearer token jako jakýkoliv jiný požadavek.
  • Soubory .proto, pokud raději chcete schéma přibalit 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čkovém poli authorization, stejně jako REST v hlavičce Authorization. Chyby přicházejí jako gRPC status kód v odpovědních trailerích 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í”