Skip to content
Wink

REST at gRPC

Nagbibigay ang Wink ng dalawang transport. Alin ang gagamitin mo ay depende sa API na iyong ini-integrate.

TransportSchemaDocs
Karamihan ng Wink APIsREST sa HTTPSOpenAPI 3Anumang grupo sa ilalim ng API sa sidebar
Partner Integrator APIgRPC sa HTTP/2Protocol BuffersPartner

Gumawa ng REST client

Section titled “Gumawa ng REST client”

Bawat API group ay naglalathala ng OpenAPI 3 na dokumento. Ituro ang anumang OpenAPI generator dito at makakakuha ka ng typed client sa iyong wika.

Terminal window
# Ang spec para sa isang grupo ay naka-serve katabi ng reference page nito.
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

Mga OpenAPI generator ayon sa wika

Gumawa ng gRPC client

Section titled “Gumawa ng gRPC client”

Ang Partner Integrator API ay gRPC. Gumagawa ka ng client mula sa .proto schema, na inilalathala ng Wink sa dalawang paraan:

  • Server reflection — inilalarawan ng server ang sarili nito, kaya ang mga tool tulad ng grpcurl, Postman at Insomnia ay maaaring matuklasan ang schema habang tumatakbo nang walang kailangang i-download na mga file. Nangangailangan ang reflection ng parehong bearer token tulad ng sa ibang tawag.
  • Ang mga .proto files, kung nais mong i-vendor ang schema at gumawa nang maaga.
Terminal window
# Tuklasin ang schema mula sa tumatakbong server (authenticated).
grpcurl -H "authorization: Bearer $WINK_TOKEN" \
  partner.wink.travel:443 list


# Pagkatapos gumawa ng client — dito ay Go; pareho ang proseso sa lahat ng suportadong wika.
protoc --go_out=. --go-grpc_out=. partner_lookup.proto

Dala ng mga tawag ang iyong bearer token sa authorization metadata header, katulad ng REST na nagdadala nito sa Authorization header. Ang mga error ay dumarating bilang gRPC status code sa response trailers sa halip na HTTP status code — ang Partner reference ay naglilista ng mga status na dapat mong asahan.

Mga mabilisang pagsisimula sa gRPC ayon sa wika

Ano ang gRPC?

O hayaan ang MCP server na isulat ito

Section titled “O hayaan ang MCP server na isulat ito”

Kung gumagamit ka ng AI coding assistant, ang aming MCP server ang pinakamabilis na ruta. Inilalantad nito ang mga API ng Wink bilang mga tool na maaaring tawagan at pag-isipan ng iyong assistant, kaya sa halip na gumawa ng buong client at hanapin ang mga endpoint nang mag-isa, ilarawan mo lang ang iyong binubuo at makakakuha ka ng integration code na nakaayon dito.

I-set up ang Wink MCP server

Karagdagang babasahin

Section titled “Karagdagang babasahin”