Skip to content
Wink

REST i gRPC

Wink izlaže dva transporta. Koji ćete koristiti ovisi o tome s kojom se API-jem integrirate.

TransportShemaDokumentacija
Većina Wink API-jaREST preko HTTPS-aOpenAPI 3Bilo koja grupa pod API u bočnoj traci
Partner Integrator APIgRPC preko HTTP/2Protocol BuffersPartner

Generirajte REST klijenta

Section titled “Generirajte REST klijenta”

Svaka API grupa objavljuje OpenAPI 3 dokument. Usmjerite bilo koji OpenAPI generator na njega i dobit ćete tipiziranog klijenta u vašem jeziku.

Terminal window
# Specifikacija za grupu se poslužuje uz njezinu referentnu stranicu.
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

Generirajte gRPC klijenta

Section titled “Generirajte gRPC klijenta”

Partner Integrator API je gRPC. Generirate klijenta iz .proto sheme, koju Wink objavljuje na dva načina:

  • Server reflection — server sam opisuje sebe, tako da alati poput grpcurl, Postman i Insomnia mogu otkriti shemu u runtime-u bez potrebe za preuzimanjem datoteka. Reflection zahtijeva isti bearer token kao i bilo koji drugi poziv.
  • .proto datoteke, ako radije želite imati shemu lokalno i generirati unaprijed.
Terminal window
# Otkrijte shemu s pokrenutog servera (autentificirano).
grpcurl -H "authorization: Bearer $WINK_TOKEN" \
  partner.wink.travel:443 list


# Zatim generirajte klijenta — ovdje 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 metapodatkovnom zaglavlju, točno kao što REST nosi u Authorization zaglavlju. Pogreške dolaze kao gRPC statusni kod u odgovorima u trailerima, a ne kao HTTP statusni kod — Partner referenca navodi statuse koje trebate očekivati.

gRPC brzi početci po jeziku

Što je gRPC?

Ili dopustite MCP serveru da napiše kod

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

Ako koristite AI asistenta za kodiranje, naš MCP server je najbrži put. Izlaže Wink API-je kao alate koje vaš asistent može pozivati i razumjeti, tako da umjesto da generirate cijelog klijenta i sami tražite krajnje točke, opisujete što gradite i dobivate integracijski kod prilagođen tome.

Postavite Wink MCP server

Daljnje čitanje

Section titled “Daljnje čitanje”