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
# Kiekvienos grupės specifikacija yra atsisiuntimas šiame puslapyje: /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 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 aptikti schemą vykdymo metu be jokių failų atsisiuntimo. Refleksijai reikalingas tas pats nešiklio tokenas kaip ir bet kuriam kitam kvietimui.
  • .proto failai, jei norite turėti schemą vietoje ir generuoti iš anksto.
Terminal window
# Aptikite schemą iš veikiantį serverio (autentifikuotai).
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 tokeną 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 referencijoje išvardyti statusai, kurių turėtumėte tikėtis.

gRPC greitas pradžios vadovas 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ų, jūs aprašote, ką kuriate, ir gaunate integracijos kodą, pritaikytą tam.

Įdiekite Wink MCP serverį

Tolimesnė medžiaga

Section titled “Tolimesnė medžiaga”