Hoppa till innehåll
Wink

REST och gRPC

Wink erbjuder två transportmetoder. Vilken du använder beror på vilken API du integrerar med.

TransportSchemaDokumentation
De flesta Wink-API:erREST över HTTPSOpenAPI 3Vilken grupp som helst under API i sidofältet
Partner Integrator APIgRPC över HTTP/2Protocol BuffersPartner

Generera en REST-klient

Section titled “Generera en REST-klient”

Varje API-grupp publicerar ett OpenAPI 3-dokument. Rikta vilken OpenAPI-generator som helst mot det så får du en typad klient i ditt språk.

Terminal window
# Specifikationen för en grupp serveras bredvid dess referenssida.
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 per språk

Generera en gRPC-klient

Section titled “Generera en gRPC-klient”

Partner Integrator API är gRPC. Du genererar en klient från .proto-schemat, som Wink publicerar på två sätt:

  • Server reflection — servern beskriver sig själv, så verktyg som grpcurl, Postman och Insomnia kan upptäcka schemat vid körning utan att ladda ner filer. Reflection kräver samma bearer-token som alla andra anrop.
  • .proto-filerna, om du hellre vill leverera schemat och generera i förväg.
Terminal window
# Upptäck schemat från en körande server (autentiserad).
grpcurl -H "authorization: Bearer $WINK_TOKEN" \
  partner.wink.travel:443 list


# Generera sedan en klient — här Go; varje stödspråk fungerar på samma sätt.
protoc --go_out=. --go-grpc_out=. partner_lookup.proto

Anrop bär din bearer-token i metadatahuvudet authorization, precis som REST bär den i Authorization-huvudet. Fel kommer som en gRPC-statuskod i svarstrailers istället för som en HTTP-statuskod — Partner-referensen listar de statusar du bör förvänta dig.

gRPC snabbstarter per språk

Vad är gRPC?

Eller låt MCP-servern skriva koden

Section titled “Eller låt MCP-servern skriva koden”

Om du använder en AI-kodassistent är vår MCP-server den snabbaste vägen. Den exponerar Winks API:er som verktyg som din assistent kan anropa och resonera kring, så istället för att generera en hel klient och själv hitta endpoints beskriver du vad du bygger och får integrationskod anpassad efter det.

Sätt upp Wink MCP-servern

Vidare läsning

Section titled “Vidare läsning”