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.

# Minden csoport specifikációja letölthető ezen az oldalon: /api/downloads/<group>.json
curl -o wink-extranet.json https://wink.travel/api/downloads/extranet.json

npx @openapitools/openapi-generator-cli generate \
  -i wink-extranet.json -g typescript-fetch -o ./wink-client

OpenAPI generátorok nyelvenként

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, fájlok letöltése nélkül felfedezhetik a sémát. 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; minden támogatott nyelv ugyanígy 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 trailerében, nem HTTP státuszkódként — a Partner referencia felsorolja a várható státuszokat.

gRPC gyors kezdők nyelvenként

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 az integrációs kódot az esetedhez igazítva kapod meg.

Á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