Sari la conținut
Wink

REST și gRPC

Wink oferă două tipuri de transport. Care dintre ele o folosești depinde de API-ul cu care te integrezi.

TransportSchemaDocs
Majoritatea API-urilor WinkREST peste HTTPSOpenAPI 3Orice grup din API din bara laterală
Partner Integrator APIgRPC peste HTTP/2Protocol BuffersPartner

Generează un client REST

Secțiune intitulată „Generează un client REST”

Fiecare grup de API publică un document OpenAPI 3. Direcționează orice generator OpenAPI către el și obții un client tipizat în limbajul tău.

Terminal window
# Specificația pentru un grup este servită lângă pagina sa de referință.
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

Generatoare OpenAPI după limbaj

Generează un client gRPC

Secțiune intitulată „Generează un client gRPC”

Partner Integrator API este gRPC. Generezi un client din schema .proto, pe care Wink o publică în două moduri:

  • Server reflection — serverul se descrie singur, astfel încât unelte precum grpcurl, Postman și Insomnia pot descoperi schema la rulare fără fișiere de descărcat. Reflection necesită același token bearer ca orice alt apel.
  • Fișierele .proto, dacă preferi să incluzi schema și să generezi în avans.
Terminal window
# Descoperă schema de la un server activ (autentificat).
grpcurl -H "authorization: Bearer $WINK_TOKEN" \
  partner.wink.travel:443 list


# Apoi generează un client — aici Go; fiecare limbaj suportat funcționează la fel.
protoc --go_out=. --go-grpc_out=. partner_lookup.proto

Apelurile poartă tokenul tău bearer în antetul metadata authorization, exact cum REST îl poartă în antetul Authorization. Erorile sosesc ca un cod de stare gRPC în trailer-ele răspunsului, nu ca un cod de stare HTTP — referința Partner listează codurile de stare pe care trebuie să le aștepți.

Porniri rapide gRPC după limbaj

Ce este gRPC?

Sau lasă serverul MCP să scrie codul

Secțiune intitulată „Sau lasă serverul MCP să scrie codul”

Dacă folosești un asistent AI pentru programare, serverul nostru MCP este cea mai rapidă cale. Expune API-urile Wink ca unelte pe care asistentul tău le poate apela și analiza, astfel încât în loc să generezi un client complet și să cauți singur endpoint-urile, descrii ce construiești și primești cod de integrare adaptat acelui scop.

Configurează serverul Wink MCP

Lecturi suplimentare

Secțiune intitulată „Lecturi suplimentare”