Saltar al contingut
Wink

REST i gRPC

Wink exposa dos transports. Quin utilitzeu depèn de quina API esteu integrant.

TransportEsquemaDocumentació
La majoria d’APIs de WinkREST sobre HTTPSOpenAPI 3Qualsevol grup sota API a la barra lateral
Partner Integrator APIgRPC sobre HTTP/2Protocol BuffersPartner

Generar un client REST

Section titled “Generar un client REST”

Cada grup d’API publica un document OpenAPI 3. Apunteu qualsevol generador OpenAPI a aquest document i obtindreu un client tipat en el vostre llenguatge.

Finestra del terminal
# L’especificació per a un grup es serveix al costat de la seva pàgina de referència.
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

Generadors OpenAPI per llenguatge

Generar un client gRPC

Section titled “Generar un client gRPC”

La Partner Integrator API és gRPC. Genereu un client a partir de l’esquema .proto, que Wink publica de dues maneres:

  • Reflexió del servidor — el servidor es descriu a si mateix, així que eines com grpcurl, Postman i Insomnia poden descobrir l’esquema en temps d’execució sense fitxers per descarregar. La reflexió requereix el mateix token bearer que qualsevol altra crida.
  • Els fitxers .proto, si preferiu incorporar l’esquema i generar-lo prèviament.
Finestra del terminal
# Descobrir l’esquema des d’un servidor en execució (autenticat).
grpcurl -H "authorization: Bearer $WINK_TOKEN" \
  partner.wink.travel:443 list


# Després genereu un client — aquí Go; cada llenguatge suportat funciona igual.
protoc --go_out=. --go-grpc_out=. partner_lookup.proto

Les crides porten el vostre token bearer a la capçalera de metadades authorization, exactament com REST el porta a la capçalera Authorization. Els errors arriben com un codi d’estat gRPC als trailers de la resposta en lloc d’un codi d’estat HTTP — la referència Partner llista els estats que heu d’esperar.

Inicis ràpids gRPC per llenguatge

Què és gRPC?

O deixeu que el servidor MCP ho escrigui

Section titled “O deixeu que el servidor MCP ho escrigui”

Si utilitzeu un assistent de codificació AI, el nostre servidor MCP és la ruta més ràpida. Exposa les APIs de Wink com a eines que el vostre assistent pot cridar i raonar, així que en lloc de generar un client complet i trobar els endpoints vosaltres mateixos, descriviu què esteu construint i obtindreu codi d’integració adaptat a això.

Configureu el servidor MCP de Wink

Lectures addicionals

Section titled “Lectures addicionals”