Skip to content
Wink

REST in gRPC

Wink ponuja dva transporta. Kateri boste uporabili, je odvisno od tega, s katerim API-jem se integrirate.

TransportShemaDokumentacija
Večina Wink API-jevREST prek HTTPSOpenAPI 3Katera koli skupina pod API v stranski vrstici
Partner Integrator APIgRPC prek HTTP/2Protocol BuffersPartner

Ustvarite REST odjemalca

Section titled “Ustvarite REST odjemalca”

Vsaka skupina API-jev objavi dokument OpenAPI 3. Usmerite katerikoli generator OpenAPI nanj in dobite tipiziran odjemalec v vašem jeziku.

Terminal window
# Specifikacijo vsake skupine lahko prenesete na tej strani: /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 generatorji po jezikih

Ustvarite gRPC odjemalca

Section titled “Ustvarite gRPC odjemalca”

Partner Integrator API je gRPC. Odjemalca ustvarite iz .proto sheme, ki jo Wink objavlja na dva načina:

  • Server reflection — strežnik se sam opiše, zato orodja, kot so grpcurl, Postman in Insomnia, lahko med izvajanjem odkrijejo shemo brez prenosa datotek. Reflection zahteva isti žeton nosilca kot kateri koli drug klic.
  • Datoteke .proto, če raje vključite shemo in ustvarite odjemalca vnaprej.
Terminal window
# Odkrijte shemo iz delujočega strežnika (avtenticirano).
grpcurl -H "authorization: Bearer $WINK_TOKEN" \
  partner.wink.travel:443 list


# Nato ustvarite odjemalca — tukaj Go; vsak podprt jezik deluje enako.
protoc --go_out=. --go-grpc_out=. partner_lookup.proto

Klici nosijo vaš žeton nosilca v metapodatkovnem glavi authorization, enako kot REST v glavi Authorization. Napake pridejo kot gRPC statusna koda v odzivnih zaključkih namesto kot HTTP statusna koda — Partnerjeva referenca navaja statuse, ki jih lahko pričakujete.

Hitri začetki gRPC po jezikih

Kaj je gRPC?

Ali pa naj MCP strežnik napiše kodo

Section titled “Ali pa naj MCP strežnik napiše kodo”

Če uporabljate AI pomočnika za kodiranje, je naš MCP strežnik najhitrejša pot. Ponuja Wink API-je kot orodja, ki jih lahko vaš pomočnik kliče in razume, tako da namesto da ustvarite celoten odjemalec in sami iščete končne točke, opišete, kaj gradite, in dobite integracijsko kodo, prilagojeno temu.

Nastavite Wink MCP strežnik

Nadaljnje branje

Section titled “Nadaljnje branje”