Pāriet uz saturu
Wink

REST un gRPC

Wink piedāvā divus transporta veidus. Kuru izmantot, ir atkarīgs no tā, ar kuru API jūs integrējaties.

TransportsShēmaDokumentācija
Lielākā daļa Wink APIREST pār HTTPSOpenAPI 3Jebkura grupa sadaļā API sānjoslā
Partneru integratora APIgRPC pār HTTP/2Protocol BuffersPartneris

Ģenerēt REST klientu

Section titled “Ģenerēt REST klientu”

Katrs API grupas publicē OpenAPI 3 dokumentu. Norādiet jebkuru OpenAPI ģeneratoru uz to, un jūs saņemsiet tipizētu klientu jūsu valodā.

Terminal window
# Grupas specifikācija tiek pasniegta blakus tās atsauces lapai.
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 ģeneratori pēc valodas

Ģenerēt gRPC klientu

Section titled “Ģenerēt gRPC klientu”

Partneru integratora API ir gRPC. Jūs ģenerējat klientu no .proto shēmas, ko Wink publicē divos veidos:

  • Servera atspoguļojums — serveris apraksta sevi, tāpēc rīki kā grpcurl, Postman un Insomnia var atklāt shēmu izpildes laikā bez failu lejupielādes. Atspoguļojumam nepieciešams tas pats piekļuves tokens kā jebkuram citam izsaukumam.
  • .proto faili, ja vēlaties shēmu saglabāt un ģenerēt iepriekš.
Terminal window
# Atklājiet shēmu no darbojoša servera (autentificēts).
grpcurl -H "authorization: Bearer $WINK_TOKEN" \
  partner.wink.travel:443 list


# Tad ģenerējiet klientu — šeit Go; katra atbalstītā valoda darbojas līdzīgi.
protoc --go_out=. --go-grpc_out=. partner_lookup.proto

Izsaukumi nes jūsu piekļuves tokenu authorization metadatu galvenē, tieši tāpat kā REST to nes Authorization galvenē. Kļūdas tiek saņemtas kā gRPC statusa kods atbildes pēcgabalos, nevis kā HTTP statusa kods — Partneru atsauce uzskaita statusus, ko jāgaida.

gRPC ātrās sākšanas rokasgrāmatas pēc valodas

Kas ir gRPC?

Vai ļaujiet MCP serverim to uzrakstīt

Section titled “Vai ļaujiet MCP serverim to uzrakstīt”

Ja izmantojat AI kodēšanas palīgu, mūsu MCP serveris ir ātrākais ceļš. Tas piedāvā Wink API kā rīkus, ko jūsu palīgs var izsaukt un analizēt, tāpēc, nevis ģenerējot pilnu klientu un meklējot galapunktus pats, jūs aprakstāt, ko veidojat, un saņemat integrācijas kodu, kas pielāgots tam.

Uzstādīt Wink MCP serveri

Papildu lasāmviela

Section titled “Papildu lasāmviela”