Skip to content
Wink

REST ir gRPC

Wink siūlo du transporto būdus. Kurį naudosite, priklauso nuo to, su kuria API integruojatės.

TransportasSchemaDokumentacija
Dauguma Wink APIREST per HTTPSOpenAPI 3Bet kuri grupė po API šoninėje juostoje
Partner Integrator APIgRPC per HTTP/2Protocol BuffersPartner

Sugeneruokite REST klientą

Section titled “Sugeneruokite REST klientą”

Kiekviena API grupė skelbia OpenAPI 3 dokumentą. Nukreipkite bet kurį OpenAPI generatorių į jį ir gausite tipizuotą klientą savo kalba.

Terminal window
# Grupės specifikacija pateikiama šalia jos nuorodos puslapio.
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 generatoriai pagal kalbą

Sugeneruokite gRPC klientą

Section titled “Sugeneruokite gRPC klientą”

Partner Integrator API yra gRPC. Jūs sugeneruojate klientą iš .proto schemos, kurią Wink skelbia dviem būdais:

  • Serverio refleksija — serveris aprašo save, todėl įrankiai kaip grpcurl, Postman ir Insomnia gali rasti schemą vykdymo metu be jokių failų atsisiuntimo. Refleksija reikalauja tokio paties nešiklio žetono kaip ir bet kuris kitas kvietimas.
  • .proto failai, jei norite turėti schemą vietoje ir generuoti iš anksto.
Terminal window
# Suraskite schemą iš veikiančio serverio (autentifikuoto).
grpcurl -H "authorization: Bearer $WINK_TOKEN" \
  partner.wink.travel:443 list


# Tada sugeneruokite klientą — čia Go; kiekviena palaikoma kalba veikia taip pat.
protoc --go_out=. --go-grpc_out=. partner_lookup.proto

Kvietimai perduoda jūsų nešiklio žetoną authorization metaduomenų antraštėje, tiksliai taip pat, kaip REST naudoja Authorization antraštę. Klaidos pateikiamos kaip gRPC statuso kodas atsakymo pabaigoje, o ne kaip HTTP statuso kodas — Partnerio nuoroda nurodo statusus, kurių turėtumėte tikėtis.

gRPC greitos pradžios pagal kalbą

Kas yra gRPC?

Arba leiskite MCP serveriui parašyti kodą

Section titled “Arba leiskite MCP serveriui parašyti kodą”

Jei naudojate AI programavimo asistentą, mūsų MCP serveris yra greičiausias kelias. Jis pateikia Wink API kaip įrankius, kuriuos jūsų asistentas gali kviesti ir analizuoti, todėl vietoje to, kad generuotumėte visą klientą ir patys ieškotumėte galinių taškų, aprašote, ką kuriate, ir gaunate integracijos kodą, pritaikytą tam.

Įdiekite Wink MCP serverį

Tolimesnė medžiaga

Section titled “Tolimesnė medžiaga”