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 pre skupinu je dostupná vedľa jej referenčnej 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 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 nutnosti 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 tak, ako REST ho nesie 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. Umožňuje, aby Wink API boli nástrojmi, 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”