Skip to content
Wink

REST in gRPC

Wink ponuja dva transporta. Kateri uporabite, 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

Generirajte REST odjemalca

Section titled “Generirajte REST odjemalca”

Vsaka skupina API-jev objavi dokument OpenAPI 3. Usmerite kateri koli generator OpenAPI nanj in dobite tipiziranega odjemalca v vašem jeziku.

Terminal window
# Specifikacija za skupino je na voljo poleg njene referenčne strani.
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 generatorji po jezikih

Generirajte gRPC odjemalca

Section titled “Generirajte gRPC odjemalca”

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

  • Server reflection — strežnik se sam opiše, tako da 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 generirate vnaprej.
Terminal window
# Odkrijte shemo iz delujočega strežnika (avtenticirano).
grpcurl -H "authorization: Bearer $WINK_TOKEN" \
  partner.wink.travel:443 list


# Nato generirajte 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 o njih razmišlja, tako da namesto da generirate 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”