Skip to content
Wink

REST ja gRPC

Wink pakub kahte transpordimeetodit. Millist kasutada, sõltub sellest, millise API-ga te integreerite.

TransportSkeemDokumentatsioon
Enamik Wink API-sidREST üle HTTPSOpenAPI 3Kõik grupid, mis on külgribal API all
Partner Integrator APIgRPC üle HTTP/2Protocol BuffersPartner

Genereeri REST klient

Section titled “Genereeri REST klient”

Iga API grupp avaldab OpenAPI 3 dokumendi. Suunake mis tahes OpenAPI generaator sellele ja saate oma keeles tüübistatud kliendi.

Terminal window
# Grupi spetsifikatsioon on saadaval selle viite lehe kõrval.
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 generaatorid keelte kaupa

Genereeri gRPC klient

Section titled “Genereeri gRPC klient”

Partner Integrator API on gRPC. Genereerite kliendi .proto skeemist, mida Wink avaldab kahel viisil:

  • Serveri peegeldus — server kirjeldab ennast, nii et tööriistad nagu grpcurl, Postman ja Insomnia saavad skeemi jooksvalt avastada ilma faile alla laadimata. Peegeldus nõuab sama bearer tokenit nagu iga teinegi päring.
  • .proto failid, kui soovite skeemi eelnevalt hankida ja genereerida.
Terminal window
# Avasta skeem töötavast serverist (autentitud).
grpcurl -H "authorization: Bearer $WINK_TOKEN" \
  partner.wink.travel:443 list


# Seejärel genereeri klient — siin Go; iga toetatud keel töötab samamoodi.
protoc --go_out=. --go-grpc_out=. partner_lookup.proto

Päringud kannavad teie bearer tokenit authorization metaandmete päises, täpselt nagu REST kannab seda Authorization päises. Veateated tulevad gRPC staatusekoodina vastuse jaluses, mitte HTTP staatusekoodina — Partneri viide loetleb oodatavad staatused.

gRPC kiire algus keelte kaupa

Mis on gRPC?

Või lase MCP serveril see kirjutada

Section titled “Või lase MCP serveril see kirjutada”

Kui kasutate AI koodiassistenti, on meie MCP server kiireim tee. See pakub Wink API-sid tööriistadena, mida teie assistent saab kutsuda ja mille üle mõelda, nii et selle asemel, et genereerida terve klient ja ise lõpp-punktid leida, kirjeldage, mida ehitate, ja saate integratsioonikoodi, mis on kohandatud teie vajadustele.

Seadista Wink MCP server

Täiendav lugemine

Section titled “Täiendav lugemine”