Skip to content
Wink

REST og gRPC

Wink tilbyr to transportmetoder. Hvilken du bruker avhenger av hvilken API du integrerer med.

TransportSkjemaDokumentasjon
De fleste Wink-APIerREST over HTTPSOpenAPI 3Enhver gruppe under API i sidemenyen
Partner Integrator APIgRPC over HTTP/2Protocol BuffersPartner

Generer en REST-klient

Section titled “Generer en REST-klient”

Hver API-gruppe publiserer et OpenAPI 3-dokument. Pek en hvilken som helst OpenAPI-generator mot det, så får du en typet klient i ditt språk.

Terminal window
# Spesifikasjonen for en gruppe serveres ved siden av referansesiden.
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-generatorer etter språk

Generer en gRPC-klient

Section titled “Generer en gRPC-klient”

Partner Integrator API er gRPC. Du genererer en klient fra .proto-skjemaet, som Wink publiserer på to måter:

  • Server reflection — serveren beskriver seg selv, slik at verktøy som grpcurl, Postman og Insomnia kan oppdage skjemaet i kjøretid uten filer å laste ned. Reflection krever samme bearer-token som alle andre kall.
  • .proto-filene, hvis du heller vil levere skjemaet selv og generere på forhånd.
Terminal window
# Oppdag skjemaet fra en kjørende server (autentisert).
grpcurl -H "authorization: Bearer $WINK_TOKEN" \
  partner.wink.travel:443 list


# Deretter generer en klient — her Go; alle støttede språk fungerer på samme måte.
protoc --go_out=. --go-grpc_out=. partner_lookup.proto

Kallene bærer ditt bearer-token i authorization metadata-headeren, akkurat som REST bærer det i Authorization-headeren. Feil kommer som en gRPC-statuskode i responsens trailers i stedet for som en HTTP-statuskode — Partner-referansen lister statusene du bør forvente.

gRPC raske starter etter språk

Hva er gRPC?

Eller la MCP-serveren skrive det

Section titled “Eller la MCP-serveren skrive det”

Hvis du bruker en AI-kodeassistent, er vår MCP-server den raskeste veien. Den eksponerer Winks APIer som verktøy assistenten din kan kalle og resonnere rundt, så i stedet for å generere en hel klient og finne endepunktene selv, beskriver du hva du bygger og får integrasjonskode tilpasset det.

Sett opp Wink MCP-serveren

Videre lesning

Section titled “Videre lesning”