Partner API

A Wink Partner API az azonosított, nagyobb áteresztőképességű módja annak, hogy az integrátorok lekérdezzék a foglalható utazási készletet — ugyanazt a kínálatot, amely táplálja beágyazható widgetjeinket és a nyilvános böngészési végpontokat, első osztályú programozható felületként elérhetővé téve. Míg az ingyenes Web Components és a nyilvános böngészési végpontok könnyű, emberi felhasználásra szánt beágyazásra készültek, a Partner API olyan rendszerekhez készült, amelyek nagy léptékben keresnek, áraznak és foglalnak. A hozzáférés integrátoronként azonosított és használat alapján számlázott, így csak az általad ténylegesen küldött forgalomért fizetsz.

Tervek és árképzés

A használatot hotel-éjszakákban mérjük: egy hotel ára egy éjszakára — nem egy API hívás. Egy olyan keresés, amely 20 hotelt ad vissza 3 éjszakára, egyetlen kérésből 60 hotel-éjszaka. A Content és Lookup (célállomás keresés és automatikus kiegészítés) hívások kivételek: ezek hívásonként egy egységet számolnak, bármit is adnak vissza. A fiók végpontok ingyenesek. Az Árazás a hiteles forrás az árak tekintetében.

	Ingyenes	Fizetős	Vállalati
Ár	0 $	Használat alapú	Kapcsolatfelvétel
Legjobb	Értékelés és alacsony forgalmú integrációk	Fizess a használat után, nagy léptékű áteresztőképesség	Egyedi volumen és tárgyalt feltételek
Egységek havonta	10 000	Korlátlan	Korlátlan
API válaszidő (P95)	—	500 ms alatt	500 ms alatt
Egységár (hotel-éjszaka)	Ingyenes	0,0001 $	Egyedi
Válasz a havi keret elérésénél	429 a következő hónap 1-jéig (UTC)	Számlázott, nem blokkolt	Megállapodás szerint
Szolgáltatási szint megállapodás	—	✓	✓
Prioritásos támogatás	—	✓	✓
Dedikált bevezetés	—	—	✓

API kulcs igénylése · Használat alapú számlázás indítása · Kapcsolatfelvétel az értékesítéssel

API referencia

Két felület szolgálja ki a foglalható készletet, amelyek megfelelnek a fent említett két szintnek:

• Ingyenes — Fogyasztói / Foglalási motor API (REST, /api/public/**): névtelen, böngésző- és widget-felületű. Foglalási motor referencia böngészése →
• Fizetős — Partner Integrátor API (gRPC, wink.partner.v1): azonosított, használat alapú, nagy léptékű szerver-szerver integrációhoz. Integrátor referencia böngészése →

A Partner Integrátor API gRPC alapú, nem REST. Egy generált klienssel hívható HTTP/2-n keresztül a partner.wink.travel:443 címen, egy bearer tokennel és a hívott fiókkal:

grpcurl -H "authorization: Bearer $WINK_TOKEN" partner.wink.travel:443 list

A fenti referencia oldal dokumentál minden szolgáltatást, üzenetet és hibastátuszt, és a séma futásidőben is elérhető szerver-reflexióval, így a grpcurl, Postman és Insomnia letöltés nélkül felfedezi azt.

Ha inkább előre generálnál klienst, a .proto forrásfájlok elérhetők a github.com/wink-travel/partner-api-proto címen.

Hogyan működik a használat és a korlátok

Ingyenes szint

Az Ingyenes szint célja, hogy költségmentesen építhess, tesztelhess és mérsékelt termelési forgalmat futtathass.

• Nincs közzétett perces limit. A Wink figyeli a kérésmennyiséget, és alkalmazhat méltányos használati korlátokat a szolgáltatás védelmére. Ha HTTP 429 (Túl sok kérés) választ kapsz, várj a Retry-After fejlécben megadott másodpercek számáig, mielőtt újrapróbálkozol.
• Havi keret — 10 000 egység naptári hónaponként. A keret fiókonként jár, és minden hónap 1-jén (UTC) újraindul. Ha eléri a keretet, és nincs beiratkozva a fizess a használat után számlázásra, akkor a fiók HTTP 429-et kap a következő hónap 1-jéig — kemény leállás, Retry-After fejléc és üzenet kíséretében, amely a Fizetős szintre való előfizetésre ösztönöz. A beiratkozott fiók tovább működik, és a kereten túli használatot számlázzák.

Az Ingyenes szint nem tartalmaz Szolgáltatási szint megállapodást vagy prioritásos támogatást.

Fizetős szint

A Fizetős szint eltávolítja a havi plafont, és csak a tényleges használat után számláz.

• Mért hotel-éjszakák — 0,0001 $ egy hotel-éjszakára. Nincs havi plafon; a tényleges volumen alapján számláznak. A Wink továbbra is alkalmazhat méltányos használati korlátokat a szolgáltatás védelmére. A keresési és készlet hívások hotel-éjszakánként számláznak; a Content és Lookup hívások egy egységet számolnak, így a kéréscsoportosítás csökkenti a számlát.

A Fizetős szint tartalmazza az alábbi Szolgáltatási szint megállapodást — 99,9%-os rendelkezésre állási kötelezettséget és 500 ms alatti P95 válaszidő célt — valamint prioritásos, súlyosság alapú támogatást.

Szolgáltatási szint megállapodás

Hatálybalépés: 2026. július 5. · Verzió 1.0

Ez a Szolgáltatási szint megállapodás (a „SLA”) meghatározza a rendelkezésre állási kötelezettséget, szolgáltatási jóváírásokat és támogatási célokat, amelyeket a Wink („Wink”, „mi”, „nekünk”) nyújt az ügyfél („Ügyfél”, „te”) számára az azonosított Wink Partner API-hoz (a „Partner API” vagy „Szolgáltatás”) azon szinteken, ahol az SLA alkalmazandó. Ez az SLA beépül és azzal az Ügyfél és Wink közötti megállapodás („Megállapodás”) szabályozza a Partner API használatát, és érvényes mindaddig, amíg aktív, fizetős Partner API előfizetéssel rendelkezel. A nagybetűs kifejezések, amelyek itt nincsenek definiálva, a Megállapodásban kapott jelentéssel bírnak.

1. Meghatározások

1. „Rendelkezésre állás” azt az időszakot jelenti, amikor a Partner API elérhető, hogy elfogadjon és sikeresen válaszoljon megfelelően formázott, azonosított kérésekre.
2. „Kiesés” bármely olyan időszak, percben mérve, amikor a Partner API nem válaszol sikeresen megfelelően formázott, azonosított kérésekre, kivéve az 4. szakaszban meghatározott kizárásokat. Az elszigetelt hibák, amelyek csak elhanyagolható részét érintik a kéréseknek, önmagukban nem minősülnek kiesésnek.
3. „Havi rendelkezésre állási százalék” adott naptári hónapra a hónap összes percéből kivonva a kiesés perceit, elosztva a hónap összes percével, százalékban kifejezve.
4. „Ütemezett karbantartás” a Szolgáltatás tervezett karbantartása, amelyről a Wink előzetesen értesítést adott az 4. szakasz szerint.
5. „Szolgáltatási jóváírás” egy jóváírás, amely a Partner API-ért az adott naptári hónapban általad fizetett vagy fizetendő díjak százalékos arányában kerül kiszámításra, és amely kizárólagos jogorvoslatként alkalmazható a rendelkezésre állási kötelezettség nem teljesülése esetén.
6. „Válaszidő” az az eltelt idő Wink által egy megfelelően formázott, azonosított kérés fogadásától a válasz küldésének megkezdéséig, kizárva a hálózati átvitel és a kliens oldali időt, amely nem a Wink ellenőrzése alatt áll.

2. Rendelkezésre állási és teljesítménykötelezettség

A Wink kereskedelmi szempontból ésszerű erőfeszítéseket tesz, hogy a Partner API elérhető legyen havi legalább 99,9%-os rendelkezésre állási százalékkal minden naptári hónapban (a „Rendelkezésre állási kötelezettség”). A kötelezettség a Wink szolgáltatási határán mérve értendő, és kizárja a Wink ésszerű ellenőrzésén kívüli tényezőket, beleértve az 4. szakaszban leírtakat. A Wink monitorozó rendszerei az irányadó források a havi rendelkezésre állási százalék és a válaszidő mérésére.

A Wink továbbá célul tűzi ki a 95. percentilis (P95) válaszidőt 500 milliszekundum alatt a sikeres, megfelelően formázott, azonosított kérések esetén, a Wink szolgáltatási határán mérve minden naptári hónapban (a „Teljesítménycél”). A Teljesítménycél kizárja az 4. szakaszban leírt tényezőket, az alkalmazásszintű hibákat okozó kéréseket, valamint a szokatlanul nagy vagy összetett csoportos kéréseket. A Teljesítménycél szolgáltatási cél, az 3. szakaszban meghatározott Szolgáltatási jóváírások kizárólag a Rendelkezésre állási kötelezettség nem teljesülése esetén alkalmazhatók, és kizárólagos jogorvoslatként szolgálnak.

3. Szolgáltatási jóváírások

Ha a havi rendelkezésre állási százalék bármely naptári hónapban a kötelezettség alá esik, jogosult lehetsz a Partner API díjaid adott hónapra eső százalékos arányú Szolgáltatási jóváírására az alábbiak szerint:

Havi rendelkezésre állási százalék	Szolgáltatási jóváírás
99,9% alatt, de legalább 99,0%	10%
99,0% alatt, de legalább 95,0%	25%
95,0% alatt	50%

1. Jóváírás igénylése. Szolgáltatási jóváírás igényléséhez írásban kell kérelmet benyújtanod a Winknek a kiesést tartalmazó naptári hónap végétől számított harminc (30) napon belül. A kérelemnek tartalmaznia kell a kiesési események időpontjait és bármilyen rendelkezésre álló naplókat vagy bizonyítékokat. A határidőn túli kérelmek nem jogosultak jóváírásra.
2. Jóváírás formája. A jóváhagyott Szolgáltatási jóváírások a jövőbeni Partner API díjak ellen kerülnek jóváírásra, készpénzértékkel nem bírnak. Nem visszatérítések, és csak a vonatkozó jogszabályok által előírt esetekben fizetendők ki.
3. Maximális jóváírás. Egyetlen naptári hónapra vonatkozóan a jóváírt Szolgáltatási jóváírások összege nem haladhatja meg az adott hónapban általad fizetett vagy fizetendő Partner API díjak 50%-át.
4. Kizárólagos jogorvoslat. A Szolgáltatási jóváírások az egyetlen és kizárólagos jogorvoslatot jelentik a Wink részéről a Rendelkezésre állási kötelezettség vagy bármely más rendelkezésre állási hiányosság esetén.

4. Kizárások

A Rendelkezésre állási kötelezettség és az ebből eredő Szolgáltatási jóváírások nem vonatkoznak, és a Kiesés nem tartalmazza azokat az időszakokat, amikor a Szolgáltatás nem elérhető, felfüggesztett, romlott vagy teljesítményprobléma lép fel az alábbi okok miatt vagy ezekhez kapcsolódóan:

1. Ütemezett karbantartás, amelyről a Wink előzetesen értesítést adott, feltéve, hogy az értesítés ésszerű idővel előre történt, a Wink által rendszeresen használt kommunikációs csatornán keresztül;
2. Vis maior események vagy egyéb, a Wink ésszerű ellenőrzésén kívüli okok, beleértve természeti katasztrófákat, kormányzati intézkedéseket, hálózati vagy közműszolgáltatói hibákat, valamint szolgáltatásmegtagadásos vagy egyéb rosszindulatú támadásokat;
3. problémák, amelyeket te vagy a te eszközeid, szoftvereid vagy hálózatod, illetve bármely harmadik fél szolgáltatása, terméke vagy szolgáltatója okoz, amely nem áll Wink közvetlen ellenőrzése alatt;
4. a Szolgáltatás visszaélése vagy a Megállapodás, ez az SLA, az elfogadható használati feltételek vagy az alkalmazandó forgalmi korlátok megsértése, beleértve a Wink által méltányosan túlzottnak ítélt forgalmat, automatizált visszaélést vagy csalást; és
5. bármely hozzáférés felfüggesztése vagy megszüntetése, amely a Megállapodás szerint jogszerűen történt, beleértve a nemfizetés miatti felfüggesztést.

5. Támogatás és válaszidő célok

A Wink a Partner API-hoz a szokásos munkaidőben nyújt támogatást, helyi ünnepnapok kivételével. A Wink kereskedelmi szempontból ésszerű erőfeszítéseket tesz, hogy a megfelelően benyújtott támogatási kérelmeket az alábbi célzott válaszidőn belül elismerje, a súlyosság alapján, amelyet te rendelsz hozzá, és amelyet a Wink ésszerűen megerősít:

Súlyosság	Leírás	Célzott első válasz
Sev 1 — Kritikus	A Partner API leállt vagy használhatatlan termelésben, megkerülő megoldás nélkül.	4 óra
Sev 2 — Jelentős	Jelentős funkció korlátozott vagy romlott; van megkerülő megoldás.	1 munkanap
Sev 3 — Kisebb	Általános kérdések, kisebb problémák vagy funkciókérések.	2 munkanap

A célzott válaszidők az első kapcsolatfelvétel időpontját jelölik; nem garantálják a megoldás idejét. A prioritásos támogatás és a súlyosság alapú célok azon szinteken érvényesek, ahol ezek szerepelnek.

6. Adatvédelem és biztonság

A Wink kereskedelmi szempontból ésszerű adminisztratív, műszaki és szervezeti intézkedéseket tart fenn az adatok bizalmasságának, sértetlenségének és rendelkezésre állásának védelmére, amelyeket a Partner API-n keresztül dolgoznak fel, és ezeket időszakosan felülvizsgálja. A Wink személyes adatok feldolgozását a Adatvédelmi szabályzat és a Megállapodásban foglalt adatkezelési feltételek szabályozzák. Te vagy felelős az API hitelesítő adataid biztonságáért, az általad lekért adatok jogszerű használatáért, és hogy haladéktalanul értesítsd a Winket bármilyen gyanított hitelesítő adat kompromittálásról.

7. Felelősségkorlátozás

A Szolgáltatási jóváírások az egyetlen és kizárólagos jogorvoslatot jelentik bármely elérhetetlenség vagy a Rendelkezésre állási kötelezettség nem teljesülése esetén, és helyettesítik az ebből eredő egyéb felelősséget. Az SLA kifejezett rendelkezésein túl a Partner API „ahogy elérhető” alapon kerül biztosításra. A vonatkozó jogszabályok által megengedett legszélesebb körben a Wink összesített felelőssége a Szolgáltatással kapcsolatban a Megállapodásban meghatározottak szerint korlátozott, és a Wink nem felel semmilyen közvetett, véletlen, különleges, következményes vagy büntető jellegű kárért, illetve elmaradt haszonért, bevételért, adatért vagy jóhírnévért, még akkor sem, ha ezek lehetőségéről értesült.

8. Időtartam, változások és megszüntetés

Ez az SLA érvényes mindaddig, amíg aktív Partner API előfizetéssel rendelkezel olyan szinten, ahol az SLA alkalmazandó. A Wink időről időre frissítheti ezt az SLA-t; a lényeges változásokat a Wink a szokásos ügyfélkommunikációs csatornán keresztül közli, és a Partner API további használata a frissítés hatályba lépése után az SLA elfogadását jelenti. Ez az SLA automatikusan megszűnik a Megállapodás vagy a Partner API előfizetés megszűnésével vagy lejártával. Azok a szakaszok, amelyek természetüknél fogva túl kell éljék a megszűnést — beleértve a felhalmozott, de igénybe nem vett Szolgáltatási jóváírási jogosultságot, a felelősségkorlátozást és a meghatározásokat — továbbra is érvényesek maradnak.