Partner API

Wink Partner API je autentifikovaný spôsob s vyššou priepustnosťou pre integrátorov na dotazovanie dostupného cestovného inventára — rovnaká ponuka, ktorá poháňa naše vkladateľné widgety a verejné prehliadacie koncové body, sprístupnená ako prvotriedne programové rozhranie. Kým bezplatné Web Components a verejné prehliadacie koncové body sú určené na ľahké, používateľsky orientované vkladanie, Partner API je postavené pre systémy, ktoré vyhľadávajú, cenia a rezervujú vo veľkom. Prístup je autentifikovaný pre každého integrátora a účtovaný podľa použitia, takže platíte len za prevádzku, ktorú skutočne odošlete.

Plány a ceny

Použitie sa meria v hotelových nociach: jeden hotel ocenený za jednu noc pobytu — nie za jeden API volanie. Vyhľadávanie, ktoré vráti 20 hotelov na 3 noci, predstavuje 60 hotelových nocí z jedného požiadavku. Výnimkou sú volania Content a Lookup (vyhľadávanie destinácie a automatické dopĺňanie): každé stojí jednu jednotku za volanie, bez ohľadu na výsledok. Koncové body účtov sú zadarmo. Cenník je zdrojom pravdy pre sadzby.

	Bezplatný	Platený	Enterprise
Cena	0 $	Podľa použitia	Kontaktujte nás
Najvhodnejší pre	Hodnotenie a integrácie s nízkym objemom	Platba podľa spotreby vo veľkom	Vlastný objem a dohodnuté podmienky
Jednotky za mesiac	10 000	Neobmedzené	Neobmedzené
Čas odozvy API (P95)	—	Pod 500 ms	Pod 500 ms
Cena za jednotku (hotelová noc)	Zadarmo	0,0001 $	Vlastné
Odozva po vyčerpaní mesačného limitu	429 až do 1. dňa nasledujúceho mesiaca (UTC)	Účtované, nie blokované	Podľa dohody
Dohoda o úrovni služieb	—	✓	✓
Prioritná podpora	—	✓	✓
Vyhradené zaškolenie	—	—	✓

Získajte API kľúč · Začnite účtovanie podľa spotreby · Kontaktujte predaj

Referencia API

Dve rozhrania slúžia na dostupný inventár a zodpovedajú dvom vyššie uvedeným úrovniam:

• Bezplatné — Consumer / Booking Engine API (REST, /api/public/**): anonymné, určené pre prehliadače a widgety. Prehliadajte referenciu Booking Engine →
• Platené — Partner Integrator API (gRPC, wink.partner.v1): autentifikované, merané podľa použitia, postavené pre integráciu server-server vo veľkom. Prehliadajte referenciu Integrátora →

Partner Integrator API je gRPC, nie REST. Voláte ho pomocou generovaného klienta cez HTTP/2 na partner.wink.travel:443, pričom posielate bearer token a účet, pre ktorý voláte:

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

Vyššie uvedená referencia dokumentuje každú službu, správu a stav chyby, a schéma je tiež k dispozícii za behu cez server reflection, takže grpcurl, Postman a Insomnia ju objavia bez nutnosti sťahovania.

Ak radšej vygenerujete klienta vopred, zdrojové súbory .proto sú zverejnené na github.com/wink-travel/partner-api-proto.

Ako funguje použitie a limity

Bezplatná úroveň

Bezplatná úroveň je navrhnutá tak, aby ste mohli vytvárať, testovať a prevádzkovať miernu produkčnú prevádzku bez nákladov.

• Žiadny zverejnený limit na minútu. Wink monitoruje rýchlosť požiadaviek a môže uplatniť limity spravodlivého používania na ochranu služby. Ak dostanete HTTP 429 (Príliš veľa požiadaviek), počkajte počet sekúnd uvedený v hlavičke Retry-After pred opakovaním.
• Mesačný limit — 10 000 jednotiek za kalendárny mesiac. Limit sa prideľuje na účet a resetuje sa 1. deň každého mesiaca (UTC). Po jeho dosiahnutí účet, ktorý nie je zapísaný na platbu podľa spotreby, dostane HTTP 429 až do 1. dňa nasledujúceho mesiaca — tvrdé zastavenie, s hlavičkou Retry-After a správou vyzývajúcou na prechod na platenú úroveň. Zapísaný účet pokračuje v práci a je účtovaný za použitie nad limit.

Bezplatná úroveň nezahŕňa dohodu o úrovni služieb ani prioritnú podporu.

Platená úroveň

Platená úroveň odstraňuje mesačný strop a účtuje vás len za to, čo použijete.

• Merané hotelové noci — 0,0001 $ za hotelovú noc. Mesačný strop neexistuje; platíte podľa skutočného objemu. Wink môže stále uplatniť limity spravodlivého používania na ochranu služby. Vyhľadávacie a inventárne volania sa účtujú podľa ocenených hotelových nocí; volania Content a Lookup účtujú jednu jednotku za volanie, takže zoskupovanie požiadaviek znižuje účet.

Platená úroveň zahŕňa dohodu o úrovni služieb popísanú nižšie — záväzok dostupnosti 99,9 % a cieľ odozvy P95 pod 500 ms — a prioritnú podporu podľa závažnosti.

Dohoda o úrovni služieb

Efektívne od: 5. júla 2026 · Verzia 1.0

Táto dohoda o úrovni služieb („SLA“) stanovuje záväzok dostupnosti, servisné kredity a ciele podpory, ktoré Wink („Wink“, „my“, „nás“) poskytuje zákazníkovi („Zákazník“, „vy“) pre autentifikované Wink Partner API („Partner API“ alebo „Služba“) na úrovniach, kde sa uvádza, že SLA platí. Táto SLA je začlenená do a riadená dohodou medzi vami a Wink, na základe ktorej pristupujete k Partner API („Dohoda“), a platí, pokiaľ máte aktívne, platené predplatné Partner API v dobrom stave. Veľké písmená, ktoré tu nie sú definované, majú význam uvedený v Dohode.

1. Definície

1. „Dostupnosť“ znamená obdobia, počas ktorých je Partner API dostupné na prijímanie a úspešné odpovedanie na správne vytvorené, autentifikované požiadavky.
2. „Nedostupnosť“ znamená akékoľvek obdobie, merané v minútach, počas ktorého Partner API neodpovedá úspešne na správne vytvorené, autentifikované požiadavky, s výnimkou období uvedených v časti 4. Izolované chyby ovplyvňujúce nepodstatnú časť požiadaviek nie sú samy o sebe Nedostupnosťou.
3. „Mesačné percento dostupnosti“ znamená pre daný kalendárny mesiac celkový počet minút v mesiaci mínus celkový počet minút Nedostupnosti, vydelené celkovým počtom minút v mesiaci, vyjadrené v percentách.
4. „Plánovaná údržba“ znamená plánovanú údržbu Služby, o ktorej Wink vopred informoval v súlade s časťou 4.
5. „Servisný kredit“ znamená kredit vypočítaný ako percento poplatkov zaplatených alebo splatných vami za Partner API v dotknutom kalendárnom mesiaci, ktorý sa uplatňuje proti budúcim poplatkom za Partner API ako jediná a výlučná náprava za nesplnenie záväzku dostupnosti.
6. „Čas odozvy“ znamená uplynutý čas medzi prijatím správne vytvoreného, autentifikovaného požiadavku na hranici služby Wink a okamihom, kedy Wink začne vracať odpoveď, bez započítania sieťového prenosu a akéhokoľvek času na strane klienta mimo kontroly Wink.

2. Záväzok dostupnosti a výkonu

Wink použije obchodne primerané úsilie, aby Partner API bolo dostupné s mesačnou dostupnosťou aspoň 99,9 % počas každého kalendárneho mesiaca trvania (ďalej len „Záväzok dostupnosti“). Záväzok dostupnosti sa meria na hranici služby Wink a nezahŕňa faktory mimo primeranej kontroly Wink, vrátane tých popísaných v časti 4. Monitorovacie systémy Wink sú autoritatívnym zdrojom na meranie mesačnej dostupnosti a času odozvy.

Wink ďalej cieli na 95. percentil (P95) času odozvy pod 500 milisekúnd pre úspešné, správne vytvorené, autentifikované požiadavky, merané na hranici služby Wink počas každého kalendárneho mesiaca (ďalej len „Cieľ výkonu“). Cieľ výkonu nezahŕňa faktory popísané v časti 4, požiadavky vracajúce aplikačné chyby spôsobené samotnou požiadavkou a nezvyčajne veľké alebo zložité dávkové požiadavky. Cieľ výkonu je cieľom služby; servisné kredity v časti 3 sa vzťahujú na nesplnenie Záväzku dostupnosti a sú jedinou a výlučnou nápravou za nedostupnosť.

3. Servisné kredity

Ak mesačné percento dostupnosti klesne pod Záväzok dostupnosti v ktoromkoľvek kalendárnom mesiaci, môžete mať nárok na servisný kredit vypočítaný ako percento poplatkov za Partner API zaplatených alebo splatných v danom mesiaci podľa nasledujúcej stupnice:

Mesačné percento dostupnosti	Servisný kredit
Pod 99,9 % ale aspoň 99,0 %	10 %
Pod 99,0 % ale aspoň 95,0 %	25 %
Pod 95,0 %	50 %

1. Uplatnenie kreditu. Na získanie servisného kreditu musíte do tridsiatich (30) dní od konca kalendárneho mesiaca, v ktorom k nedostupnosti došlo, podať písomnú žiadosť Wink. Žiadosť musí obsahovať dátumy a časy každej udalosti Nedostupnosti, na ktorú sa vzťahuje, a akékoľvek dostupné podporné záznamy alebo dôkazy. Žiadosti podané po tomto termíne nie sú oprávnené.
2. Forma kreditu. Schválené servisné kredity sa uplatňujú proti budúcim poplatkom za Partner API a nemajú hotovostnú hodnotu. Nie sú refundáciou a nebudú vyplatené, pokiaľ to nevyžaduje platný zákon.
3. Maximálny kredit. Celkové servisné kredity za ktorýkoľvek kalendárny mesiac neprekročia 50 % poplatkov za Partner API zaplatených alebo splatných v danom mesiaci.
4. Jediná a výlučná náprava. Servisné kredity sú vaša jediná a výlučná náprava za akékoľvek nesplnenie Záväzku dostupnosti alebo iné nedostupnosti Partner API.

4. Výnimky

Záväzok dostupnosti a akékoľvek servisné kredity sa nevzťahujú na a Nedostupnosť nezahŕňa žiadnu nedostupnosť, pozastavenie, zhoršenie alebo problém s výkonom, ktorý vzniká z alebo súvisí s:

1. Plánovanou údržbou, o ktorej Wink vopred informoval, pokiaľ takéto oznámenie bolo poskytnuté primerane vopred prostredníctvom kanála, ktorý Wink bežne používa na komunikáciu so zákazníkmi;
2. Nemožnosťou konať (force majeure) alebo inými príčinami mimo primeranej kontroly Wink, vrátane prírodných katastrof, vládnych zásahov, výpadkov sietí alebo služieb, a útokov typu denial-of-service alebo iných škodlivých útokov;
3. problémami spôsobenými vašimi činmi alebo opomenutiami, vaším zariadením, softvérom alebo sieťou, alebo akoukoľvek tretou stranou službou, produktom alebo poskytovateľom mimo priamej kontroly Wink;
4. vaším zneužitím Služby alebo porušením Dohody, tejto SLA, podmienok akceptovateľného používania alebo platných limitov rýchlosti, vrátane prevádzky, ktorú Wink rozumne považuje za nadmernú, automatizovaného zneužívania alebo podvodného konania; a
5. akýmkoľvek pozastavením alebo ukončením vášho prístupu riadne vykonaným podľa Dohody, vrátane pozastavenia z dôvodu neplatenia.

5. Podpora a ciele odozvy

Wink poskytuje podporu pre Partner API počas štandardných pracovných hodín, s výnimkou miestnych štátnych sviatkov. Wink použije obchodne primerané úsilie na potvrdenie správne podaných požiadaviek na podporu v nasledujúcich cieľových časoch odozvy, založených na závažnosti, ktorú priradíte a ktorú Wink primerane potvrdí:

Závažnosť	Popis	Cieľová počiatočná odozva
Sev 1 — Kritická	Partner API je nefunkčné alebo nepoužiteľné v produkcii bez obchádzky.	4 hodiny
Sev 2 — Hlavná	Významná funkcia je obmedzená alebo zhoršená; existuje obchádzka.	1 pracovný deň
Sev 3 — Menšia	Všeobecné otázky, menšie problémy alebo požiadavky na funkcie.	2 pracovné dni

Cieľové časy odozvy popisujú, kedy Wink plánuje nadviazať počiatočný kontakt; nie sú zárukou času vyriešenia. Prioritná podpora a ciele podľa závažnosti platia na úrovniach, kde sú uvedené ako zahrnuté.

6. Dáta a bezpečnosť

Wink udržiava obchodne primerané administratívne, technické a organizačné opatrenia navrhnuté na ochranu dôvernosti, integrity a dostupnosti dát spracovávaných cez Partner API a tieto opatrenia pravidelne prehodnocuje. Spracovanie osobných údajov spoločnosťou Wink sa riadi zásadami ochrany osobných údajov a akýmikoľvek podmienkami spracovania údajov v Dohode. Vy zostávate zodpovední za zabezpečenie vlastných API poverení, za zákonné použitie akýchkoľvek získaných údajov a za okamžité oznámenie Wink o akomkoľvek podozrení na kompromitáciu poverení.

7. Obmedzenie zodpovednosti

Servisné kredity sú jedinou a výlučnou nápravou za akúkoľvek nedostupnosť alebo nesplnenie Záväzku dostupnosti a poskytujú sa namiesto akejkoľvek inej zodpovednosti vyplývajúcej z takéhoto nesplnenia. Okrem výslovne uvedeného v tejto SLA sa Partner API poskytuje „tak, ako je dostupné“. V maximálnom rozsahu povolenom platným právom je celková zodpovednosť Wink vyplývajúca zo Služby obmedzená podľa Dohody a Wink nezodpovedá za žiadne nepriame, náhodné, špeciálne, následné alebo trestné škody, ani za stratu zisku, príjmov, dát alebo dobrého mena, aj keď bol upozornený na možnosť takýchto škôd.

8. Trvanie, zmeny a ukončenie

Táto SLA platí, pokiaľ máte aktívne predplatné Partner API na úrovni, kde je uvedené, že SLA platí. Wink môže túto SLA čas od času aktualizovať; podstatné zmeny budú oznámené prostredníctvom kanála, ktorý Wink bežne používa na komunikáciu so zákazníkmi, a pokračovanie v používaní Partner API po nadobudnutí účinnosti aktualizácie znamená súhlas s aktualizovanou SLA. Táto SLA zaniká automaticky pri ukončení alebo uplynutí platnosti Dohody alebo vášho predplatného Partner API. Časti, ktoré podľa svojej povahy majú prežiť ukončenie — vrátane nároku na servisné kredity, obmedzenia zodpovednosti a definícií — prežívajú.