Tovább a tartalomhoz

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 a beágyazható widgetjeinket és a nyilvános böngészési végpontokat működteti, 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 rendszerek számára 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.

Egy API hívás = egy kérés. A mért használat 1 000 kérésenként kerül számlázásra.

IngyenesFizetősVállalati
Ár0 USDHasználat alapúLépj kapcsolatba velünk
Legjobb választásÉrtékelés és alacsony forgalmú integrációkFizess a használat után, nagy léptékű áteresztőképességEgyedi volumen és tárgyalt feltételek
Kérések percenként30 (60 burst)KorlátlanKorlátlan
Kérések havonta10 000KorlátlanKorlátlan
API válaszidő (P95)500 ms alatt500 ms alatt
Ár 1 000 kérésenkéntIngyenes1,00 USDEgyedi
Look-to-book túllépés (1 000 többlet keresés 5 000:1 arány felett)2,00 USDEgyedi
Lekérdezési korlát válasz429 (szünet / havi kemény leállás)NincsNincs
Szolgáltatási szint megállapodás
Prioritásos támogatás
Dedikált bevezetés

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

Két OpenAPI felület szolgálja ki a foglalható készletet, és megfelelnek a fenti két szintnek:

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

Szekció neve “Hogyan működik a használat és a korlátok”

Az Ingyenes szint célja, hogy lehetővé tegye az építést, tesztelést és mérsékelt éles forgalom futtatását költség nélkül.

  • Lekérdezési korlát — 30 kérés percenként, 60 kéréses bursttel. A rövid ideig tartó csúcsok a burst keretből kerülnek elszámolásra. Ha túlléped, az API HTTP 429 (Túl sok kérés) választ ad, és 5 perces szünetet rendel el, mielőtt a kulcs újra forgalmat szolgálna ki. Vissza kell venni a tempóból, és a szünet után újrapróbálkozni, nem szabad folyamatosan bombázni a végpontot.
  • Havi kvóta — 10 000 kérés naptári hónaponként. Ha elérted a havi plafont, az API a hónap hátralévő részében HTTP 429 választ ad — kemény leállás — és üzenetet küld, hogy iratkozz fel a Fizetős szintre a folytatáshoz. A számláló a következő naptári hónap elején nullázódik.

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

A Fizetős szint eltávolítja a havi plafont és a lekérdezési korlát miatti szüneteket, és csak a tényleges használat után számláz.

  • Mért kérések — 1,00 USD 1 000 kérésenként. Nincs havi kéréskorlát és nincs lekérdezési korlát alatti korlátozás normál használat esetén; a számlázás a tényleges volumen alapján történik.

  • Look-to-book túllépés — 2,00 USD 1 000 többlet keresésenként. A kínálat egészséges szinten tartásához mérjük a keresések (“look”) és a megerősített foglalások arányát. Jogosult vagy 5 000 keresésre foglalásonként túllépés nélkül. A többlet keresések kiszámítása:

    többlet = max(0, keresések − foglalások × 5 000)

    A túllépés díja 2,00 USD 1 000 többlet keresésenként. Azok az integrációk, amelyek jól konvertálnak, ritkán fizetnek túllépési díjat; a díj csak a foglaláshoz képest sokkal több keresést végző forgalomra vonatkozik.

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.

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élnek (“Ügyfél”, “te”) 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”) hatálya alá tartozik, amely alapján hozzáférsz a Partner API-hoz, é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 meghatározott jelentéssel bírnak.

  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ált, 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ált, 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ének és a kiesés perceinek különbsége osztva 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ítése esetén.
  6. “Válaszidő” az az idő, amely Wink szolgáltatási határán belül a megfelelően formált, azonosított kérés fogadásától a válasz küldésének megkezdéséig telik el, kizárva a hálózati átvitel és az ügyfél oldali, Wink által nem befolyásolt időt.

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

Szekció neve “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 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 Wink szolgáltatási határán kerül mérésre, és kizárja a Wink ésszerű ellenőrzésén kívüli tényezőket, beleértve az 4. szakaszban leírtakat. Wink felügyeleti rendszerei az irányadó források a havi rendelkezésre állási százalék és a válaszidő mérésére.

Továbbá Wink célul tűzi ki a 95. percentilis (P95) válaszidőt 500 milliszekundum alatt a sikeres, megfelelően formált, azonosított kérések esetén, a szolgáltatási határon 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, azokat a kéréseket, amelyek alkalmazásszintű hibát adnak vissza a kérés miatt, valamint a szokatlanul nagy vagy összetett kötegelt kéréseket. A Teljesítménycél szolgáltatási cél, az 3. szakaszban leírt Szolgáltatási jóváírások kizárólag a Rendelkezésre állási kötelezettség nem teljesítése esetén alkalmazhatók, és kizárólagos jogorvoslatként szolgálnak.

Ha a havi rendelkezésre állási százalék bármely naptári hónapban a Rendelkezésre állási kötelezettség alá esik, jogosult lehetsz Szolgáltatási jóváírásra, amely a Partner API díjak adott hónapra fizetett vagy fizetendő összegének százalékos arányában kerül kiszámításra az alábbi táblázat szerint:

Havi rendelkezésre állási százalékSzolgá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% alatt50%
  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 Winknek a kiesés hónapjának végétől számított harminc (30) napon belül. A kérelemnek tartalmaznia kell az egyes kiesési események dátumát és időpontját, valamint minden rendelkezésre álló napló- vagy bizonyítékot. A határidőn túl benyújtott 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 elszámolá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ónapra 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 Wink bármely rendelkezésre állási kötelezettség nem teljesítése vagy bármely más Partner API rendelkezésre állási hiányosság esetén.

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, teljesítménycsökkenést mutat vagy problémás, amely az alábbiakból ered vagy azzal kapcsolatos:

  1. Ütemezett karbantartás, amelyről Wink előzetesen értesítést adott, feltéve, hogy az értesítés ésszerű idővel előre, a Wink által szokásosan használt kommunikációs csatornán történt;
  2. Vis maior események vagy egyéb, 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 berendezésed, szoftvered 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ó lekérdezési korlátok megsértése, beleértve a Wink által ésszerűen túlzónak í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.

A Wink a Partner API-hoz támogatást nyújt a szokásos munkaidőben, helyi ünnepnapok kivételével. 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 Wink ésszerűen megerősít:

SúlyosságLeírásCélzott első válasz
Sev 1 — KritikusA Partner API leállt vagy használhatatlan éles környezetben, megkerülő megoldás nélkül.4 óra
Sev 2 — JelentősJelentős funkció korlátozott vagy gyengült; 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 probléma megoldásának idejét. A prioritásos támogatás és a súlyosság alapú célok azon szinteken érvényesek, ahol ezek szerepelnek.

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ása a Adatvédelmi szabályzat és a Megállapodásban foglalt adatkezelési feltételek szerint történik. Te vagy felelős az API hitelesítő adataid biztonságáért, az általad lekért adatok jogszerű használatáért, valamint hogy haladéktalanul értesítsd Winket bármilyen gyanított hitelesítő adat kompromittálásról.

A Szolgáltatási jóváírások az egyetlen és kizárólagos jogorvoslatot jelentik bármely rendelkezésre állási hiány vagy a Rendelkezésre állási kötelezettség nem teljesítése esetén, és helyettesítik az ebből eredő egyéb felelősséget. Kivéve, ha ezt az SLA kifejezetten másként rendelkezik, a Partner API “ahogy elérhető” alapon kerül biztosításra. A hatályos 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 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 előzetesen értesült az ilyen károk lehetőségéről.

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

Szekció neve “8. Időtartam, változások és megszüntetés”

Ez az SLA mindaddig érvényes, 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 használatának folytatása 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ás jogosultságot, a felelősségkorlátozást és a meghatározásokat — hatályban maradnak.