REST és gRPC

A Wink két átviteli módot kínál. Az, hogy melyiket használod, attól függ, melyik API-val integrálódsz.

	Átviteli mód	Séma	Dokumentáció
A legtöbb Wink API	REST HTTPS-en keresztül	OpenAPI 3	Bármelyik csoport az API alatt az oldalsávban
Partner Integrátor API	gRPC HTTP/2-n keresztül	Protocol Buffers	Partner

REST kliens generálása

Minden API csoport publikál egy OpenAPI 3 dokumentumot. Mutass rá bármely OpenAPI generátorra, és kapsz egy típusos klienst a választott nyelveden.

# Egy csoport specifikációja a referencia oldal mellett érhető el.
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 generátorok nyelvek szerint

gRPC kliens generálása

A Partner Integrátor API gRPC alapú. A klienst a .proto sémából generálod, amelyet a Wink két módon tesz elérhetővé:

Szerver reflektálás — a szerver önmagát írja le, így olyan eszközök, mint a grpcurl, Postman és Insomnia futásidőben felfedezhetik a sémát fájlok letöltése nélkül. A reflektáláshoz ugyanaz a bearer token szükséges, mint bármely más híváshoz.
A .proto fájlok, ha inkább előre szeretnéd beszerezni a sémát és generálni.

# A séma felfedezése egy futó szerverről (hitelesített).
grpcurl -H "authorization: Bearer $WINK_TOKEN" \
  partner.wink.travel:443 list

# Ezután generálj klienst — itt Go nyelven; minden támogatott nyelv hasonlóan működik.
protoc --go_out=. --go-grpc_out=. partner_lookup.proto

A hívások a bearer tokenedet az authorization metaadat fejlécben viszik, ugyanúgy, ahogy a REST az Authorization fejlécben. A hibák gRPC státuszkódként érkeznek a válasz végén, nem HTTP státuszkódként — a Partner referencia felsorolja a várható státuszokat.

gRPC gyors kezdők nyelvek szerint

Mi az a gRPC?

Vagy hagyd, hogy az MCP szerver írja meg

Ha AI kódoló asszisztenst használsz, az MCP szerverünk a leggyorsabb út. A Wink API-it eszközként teszi elérhetővé, amelyeket az asszisztensed hívhat és értelmezhet, így ahelyett, hogy egész klienst generálnál és magad keresnéd meg a végpontokat, leírod, mit építesz, és kapsz az esetedhez igazított integrációs kódot.

Állítsd be a Wink MCP szervert

További olvasnivaló

Beállítás — fiókok, környezetek és hitelesítő adatok
Hitelesítés — tokenek beszerzése és frissítése
Webhook integráció — események fogadása lekérdezés helyett