Siirry sisältöön
Wink

REST ja gRPC

Wink tarjoaa kahta siirtotapaa. Kumpaa käytät, riippuu siitä, minkä API:n kanssa integroidut.

SiirtotapaSkeemaDokumentaatio
Useimmat Wink API:tREST HTTPS:n yliOpenAPI 3Mikä tahansa ryhmä API-kohdan alla sivupalkissa
Partner Integrator APIgRPC HTTP/2:n yliProtocol BuffersPartner

Generoi REST-asiakas

Osio nimeltä “Generoi REST-asiakas”

Jokainen API-ryhmä julkaisee OpenAPI 3 -dokumentin. Suuntaa mikä tahansa OpenAPI-generaattori siihen, niin saat tyypitetyn asiakkaan omalla kielelläsi.

Terminal window
# Ryhmän spesifikaatio on saatavilla sen referenssisivun vierestä.
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-generaattorit kielittäin

Generoi gRPC-asiakas

Osio nimeltä “Generoi gRPC-asiakas”

Partner Integrator API on gRPC. Generoit asiakkaan .proto-skeemasta, jonka Wink julkaisee kahdella tavalla:

  • Palvelimen reflektio — palvelin kuvaa itsensä, joten työkalut kuten grpcurl, Postman ja Insomnia voivat löytää skeeman ajonaikaisesti ilman tiedostojen lataamista. Reflektio vaatii saman bearer-tokenin kuin muutkin kutsut.
  • .proto-tiedostot, jos haluat mieluummin hallita skeemaa itse ja generoida etukäteen.
Terminal window
# Löydä skeema käynnissä olevalta palvelimelta (autentikoitu).
grpcurl -H "authorization: Bearer $WINK_TOKEN" \
  partner.wink.travel:443 list


# Sitten generoi asiakas — tässä Go; kaikki tuetut kielet toimivat samalla tavalla.
protoc --go_out=. --go-grpc_out=. partner_lookup.proto

Kutsut kuljettavat bearer-tokenisi authorization-metadataotsikossa, aivan kuten REST kuljettaa sen Authorization-otsikossa. Virheet tulevat gRPC-tilakoodina vastauksen trailer-osassa HTTP-tilakoodin sijaan — Partnerin referenssi listaa odotettavat tilakoodit.

gRPC pika-aloitukset kielittäin

Mikä on gRPC?

Tai anna MCP-palvelimen kirjoittaa se

Osio nimeltä “Tai anna MCP-palvelimen kirjoittaa se”

Jos käytät tekoälypohjaista koodausavustajaa, MCP-palvelimemme on nopein reitti. Se tarjoaa Wink API:t työkaluina, joita avustajasi voi kutsua ja joiden perusteella se voi tehdä päätelmiä, joten sen sijaan, että generoit koko asiakkaan ja etsit päätepisteet itse, kuvailet mitä rakennat ja saat integraatiokoodin käyttötapauksesi mukaan.

Ota Wink MCP -palvelin käyttöön

Lisälukemista

Osio nimeltä “Lisälukemista”