Salta ai contenuti
Wink

REST e gRPC

Wink espone due trasporti. Quale usare dipende dall’API con cui stai integrando.

TrasportoSchemaDocumentazione
La maggior parte delle API WinkREST su HTTPSOpenAPI 3Qualsiasi gruppo sotto API nella sidebar
Partner Integrator APIgRPC su HTTP/2Protocol BuffersPartner

Genera un client REST

Sezione intitolata “Genera un client REST”

Ogni gruppo di API pubblica un documento OpenAPI 3. Punta qualsiasi generatore OpenAPI su di esso e ottieni un client tipizzato nel tuo linguaggio.

Terminal window
# La specifica per un gruppo è servita accanto alla sua pagina di riferimento.
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

Generatori OpenAPI per linguaggio

Genera un client gRPC

Sezione intitolata “Genera un client gRPC”

La Partner Integrator API è gRPC. Generi un client dallo schema .proto, che Wink pubblica in due modi:

  • Server reflection — il server si descrive da solo, così strumenti come grpcurl, Postman e Insomnia possono scoprire lo schema a runtime senza scaricare file. La reflection richiede lo stesso token bearer di qualsiasi altra chiamata.
  • I file .proto, se preferisci includere lo schema nel tuo progetto e generare in anticipo.
Terminal window
# Scopri lo schema da un server in esecuzione (autenticato).
grpcurl -H "authorization: Bearer $WINK_TOKEN" \
  partner.wink.travel:443 list


# Poi genera un client — qui Go; ogni linguaggio supportato funziona allo stesso modo.
protoc --go_out=. --go-grpc_out=. partner_lookup.proto

Le chiamate trasportano il tuo token bearer nell’header metadata authorization, esattamente come REST lo trasporta nell’header Authorization. Gli errori arrivano come codice di stato gRPC nei trailer della risposta invece che come codice HTTP — il riferimento Partner elenca gli stati che dovresti aspettarti.

Avvii rapidi gRPC per linguaggio

Cos’è gRPC?

Oppure lascia che il server MCP lo scriva

Sezione intitolata “Oppure lascia che il server MCP lo scriva”

Se usi un assistente di codifica AI, il nostro server MCP è la via più veloce. Espone le API Wink come strumenti che il tuo assistente può chiamare e analizzare, così invece di generare un client completo e cercare gli endpoint da solo, descrivi cosa stai costruendo e ottieni codice di integrazione modellato su quello.

Configura il server Wink MCP

Ulteriori letture

Sezione intitolata “Ulteriori letture”