Pāriet uz saturu
Wink

REST un gRPC

Wink piedāvā divus transporta veidus. Kuru izmantosiet, 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
# Katras grupas specifikācija ir pieejama lejupielādei šajā vietnē: /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 ģ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 tādi 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 iekļaut savā projektā 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 — Partnera atsauce uzskaita statusus, ko jāparedz.

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, tā vietā, lai ģenerētu pilnu klientu un pats meklētu galapunktus, 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”