Skip to content
Wink

REST i gRPC

Wink izlaže dva transporta. Koji ćete koristiti zavisi od API-ja sa kojim se integrišete.

TransportŠemaDokumentacija
Većina Wink API-jaREST preko HTTPSOpenAPI 3Bilo koja grupa pod API u bočnoj traci
Partner Integrator APIgRPC preko HTTP/2Protocol BuffersPartner

Generisanje REST klijenta

Section titled “Generisanje REST klijenta”

Svaka API grupa objavljuje OpenAPI 3 dokument. Usmerite bilo koji OpenAPI generator na njega i dobijate tipiziranog klijenta u vašem jeziku.

Terminal window
# Specifikacija za grupu se služi pored njene referentne stranice.
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 generatori po jeziku

Generisanje gRPC klijenta

Section titled “Generisanje gRPC klijenta”

Partner Integrator API je gRPC. Generišete klijenta iz .proto šeme, koju Wink objavljuje na dva načina:

  • Server reflection — server opisuje sam sebe, tako da alati poput grpcurl, Postman i Insomnia mogu da otkriju šemu u toku izvršavanja bez potrebe za preuzimanjem fajlova. Reflection zahteva isti bearer token kao i bilo koji drugi poziv.
  • .proto fajlovi, ako više volite da imate šemu lokalno i generišete unapred.
Terminal window
# Otkrijte šemu sa pokrenutog servera (autentifikovano).
grpcurl -H "authorization: Bearer $WINK_TOKEN" \
  partner.wink.travel:443 list


# Zatim generišite klijenta — ovde za Go; svaki podržani jezik radi na isti način.
protoc --go_out=. --go-grpc_out=. partner_lookup.proto

Pozivi nose vaš bearer token u authorization metapodatku zaglavlja, isto kao što REST nosi u Authorization zaglavlju. Greške dolaze kao gRPC status kod u odgovorima u trailerima, a ne kao HTTP status kod — Partner referenca navodi statuse koje treba očekivati.

gRPC brzi početak po jeziku

Šta je gRPC?

Ili dozvolite MCP serveru da napiše kod

Section titled “Ili dozvolite MCP serveru da napiše kod”

Ako koristite AI asistenta za kodiranje, naš MCP server je najbrži put. On izlaže Wink API-je kao alate koje vaš asistent može pozivati i o njima razmišljati, tako da umesto da generišete ceo klijent i sami tražite krajnje tačke, opisujete šta pravite i dobijate integracioni kod prilagođen tom opisu.

Podesite Wink MCP server

Dalje čitanje

Section titled “Dalje čitanje”