Partner API
Wink Partner API je autentificirani, visokopropusni način za integratore da upituju rezervabilni inventar putovanja — ista ponuda koja pokreće naše ugrađene widgete i javne pregledne krajnje točke, izložena kao programsko sučelje prvog reda. Dok su besplatni Web Components i javne pregledne krajnje točke namijenjeni za lagano, korisnički orijentirano ugrađivanje, Partner API je izgrađen za sustave koji pretražuju, cijene i rezerviraju u velikom opsegu. Pristup je autentificiran po integratoru i naplaćuje se po korištenju, tako da plaćate samo za promet koji zapravo šaljete.
Planovi i cijene
Section titled “Planovi i cijene”Jedan API poziv = jedan zahtjev. Korištenje se mjeri i naplaćuje po 1.000 zahtjeva.
| Besplatno | Plaćeno | Enterprise | |
|---|---|---|---|
| Cijena | 0 $ | Na temelju korištenja | Kontaktirajte nas |
| Najbolje za | Evaluaciju i integracije s malim opsegom | Plaćanje po korištenju u velikom opsegu | Prilagođeni volumen i pregovarani uvjeti |
| Zahtjevi u minuti | 30 (60 u naletu) | Neograničeno | Neograničeno |
| Zahtjevi mjesečno | 10.000 | Neograničeno | Neograničeno |
| Vrijeme odgovora API-ja (P95) | — | Ispod 500 ms | Ispod 500 ms |
| Cijena po 1.000 zahtjeva | Besplatno | 1,00 $ | Prilagođeno |
| Prekoračenje omjera pregleda i rezervacije (po 1.000 viška pregleda iznad 5.000:1) | — | 2,00 $ | Prilagođeno |
| Odgovor na ograničenje brzine | 429 (pauza / mjesečni hard stop) | Nema | Nema |
| Ugovor o razini usluge | — | ✓ | ✓ |
| Prioritetna podrška | — | ✓ | ✓ |
| Posvećena integracija | — | — | ✓ |
Preuzmite API ključ · Pokrenite naplatu po korištenju · Kontaktirajte prodaju
API referenca
Section titled “API referenca”Dvije OpenAPI površine služe rezervabilnom inventaru i mapiraju se na dvije gore navedene razine:
- Besplatno — Consumer / Booking Engine API (
/api/public/**): anonimno, usmjereno na preglednik i widget. Pregledajte Booking Engine referencu → - Plaćeno — Partner Integrator API (
/api/partner/**): autentificirano, mjereno po korištenju, izgrađeno za integraciju server-server u velikom opsegu. Pregledajte Integrator referencu →
Kako funkcionira korištenje i ograničenja
Section titled “Kako funkcionira korištenje i ograničenja”Besplatna razina
Section titled “Besplatna razina”Besplatna razina je dizajnirana da vam omogući izgradnju, testiranje i pokretanje umjerenog produkcijskog prometa bez troškova.
- Ograničenje brzine — 30 zahtjeva u minuti, s naletom od 60 zahtjeva. Kratki vrhunci iznad održivog ritma pokrivaju se naletom. Ako ga prekoračite, API odgovara s HTTP 429 (Previše zahtjeva) i primjenjuje pauzu od 5 minuta prije nego što vaš ključ nastavi s prometom. Odmaknite se i pokušajte ponovno nakon pauze umjesto da preplavljujete krajnju točku.
- Mjesečni kvota — 10.000 zahtjeva po kalendarskom mjesecu. Kad dosegnite mjesečni limit, API vraća HTTP 429 za ostatak mjeseca — hard stop — zajedno s porukom koja vas poziva da se pretplatite na Plaćenu razinu za nastavak. Brojač se resetira početkom sljedećeg kalendarskog mjeseca.
Besplatna razina ne uključuje Ugovor o razini usluge niti prioritetnu podršku.
Plaćena razina
Section titled “Plaćena razina”Plaćena razina uklanja mjesečni limit i pauze zbog ograničenja brzine, a naplaćuje se samo ono što koristite.
-
Mjereni zahtjevi — 1,00 $ po 1.000 zahtjeva. Nema mjesečnog ograničenja zahtjeva niti ograničenja brzine u normalnoj upotrebi; naplaćujete se prema stvarnom volumenu.
-
Prekoračenje omjera pregleda i rezervacije — 2,00 $ po 1.000 viška pregleda. Da bi ponuda ostala zdrava, mjerimo omjer pretraživanja (“pregleda”) i potvrđenih rezervacija. Imate pravo na 5.000 pregleda po rezervaciji prije nego što se prekoračenje primijeni. Višak pregleda računa se kao:
excess = max(0, looks − bookings × 5,000)Prekoračenje se zatim naplaćuje po 2,00 $ za 1.000 viška pregleda. Integracije koje dobro konvertiraju rijetko imaju prekoračenja; naknada se primjenjuje samo na promet koji pretražuje znatno više nego što rezervira.
Plaćena razina uključuje Ugovor o razini usluge opisan u nastavku — obvezu dostupnosti od 99,9% i cilj vremena odgovora P95 ispod 500 ms — te prioritetnu podršku temeljenu na ozbiljnosti problema.
Ugovor o razini usluge
Section titled “Ugovor o razini usluge”Datum stupanja na snagu: 5. srpnja 2026. · Verzija 1.0
Ovaj Ugovor o razini usluge (u daljnjem tekstu “SLA”) postavlja obvezu dostupnosti, kredite za uslugu i ciljeve podrške koje Wink (“Wink”, “mi”, “nas”) pruža korisniku (“Korisnik”, “vi”) za autentificirani Wink Partner API (u daljnjem tekstu “Partner API” ili “Usluga”) na razinama na kojima je navedeno da SLA vrijedi. Ovaj SLA je uključen u i reguliran ugovorom između vas i Wink pod kojim pristupate Partner API-ju (u daljnjem tekstu “Ugovor”) i vrijedi sve dok održavate aktivnu, plaćenu pretplatu na Partner API u dobrom stanju. Pojmovi napisani velikim slovima koji ovdje nisu definirani imaju značenje dano u Ugovoru.
1. Definicije
Section titled “1. Definicije”- “Dostupnost” znači razdoblja tijekom kojih je Partner API dostupan za prihvat i uspješan odgovor na pravilno oblikovane, autentificirane zahtjeve.
- “Nedostupnost” znači bilo koje razdoblje, mjerene u minutama, tijekom kojeg Partner API ne uspijeva uspješno odgovoriti na pravilno oblikovane, autentificirane zahtjeve, isključujući bilo koje razdoblje koje spada u Izuzetke navedene u odjeljku 4. Izolirane pogreške koje utječu na neznatan dio zahtjeva same po sebi nisu Nedostupnost.
- “Mjesečni postotak dostupnosti” znači, za određeni kalendarski mjesec, ukupan broj minuta u tom mjesecu umanjen za ukupne minute Nedostupnosti, podijeljeno s ukupnim brojem minuta u tom mjesecu, izraženo kao postotak.
- “Planirano održavanje” znači planirano održavanje Usluge za koje je Wink dao prethodnu obavijest u skladu s odjeljkom 4.
- “Kredit za uslugu” znači kredit, izračunat kao postotak naknada koje ste platili ili trebate platiti za Partner API u pogođenom kalendarskom mjesecu, koji se primjenjuje na buduće naknade za Partner API kao jedini i isključivi lijek za neispunjavanje obveze dostupnosti.
- “Vrijeme odgovora” znači proteklo vrijeme između primitka pravilno oblikovanog, autentificiranog zahtjeva na granici usluge Wink i trenutka kada Wink počne vraćati odgovor, isključujući mrežni prijenos i bilo koje vrijeme na strani klijenta izvan Winkove kontrole.
2. Obveza dostupnosti i performansi
Section titled “2. Obveza dostupnosti i performansi”Wink će koristiti komercijalno razumna nastojanja da učini Partner API dostupnim s mjesečnim postotkom dostupnosti od najmanje 99,9% tijekom svakog kalendarskog mjeseca trajanja (u daljnjem tekstu “Obveza dostupnosti”). Obveza dostupnosti mjeri se na granici usluge Wink i isključuje čimbenike izvan razumne kontrole Wink, uključujući one opisane u odjeljku 4. Winkovi sustavi za nadzor su autoritativni izvor za mjerenje mjesečnog postotka dostupnosti i vremena odgovora.
Wink dodatno cilja na vrijeme odgovora u 95. percentilu (P95) ispod 500 milisekundi za uspješne, pravilno oblikovane, autentificirane zahtjeve, mjereno na granici usluge Wink tijekom svakog kalendarskog mjeseca (u daljnjem tekstu “Cilj performansi”). Cilj performansi isključuje čimbenike opisane u odjeljku 4, zahtjeve koji vraćaju pogreške na razini aplikacije uzrokovane samim zahtjevom, te neuobičajeno velike ili složene serijske zahtjeve. Cilj performansi je cilj usluge; Krediti za uslugu iz odjeljka 3 primjenjuju se na neispunjavanje Obveze dostupnosti i jedini su i isključivi lijek za nedostatke dostupnosti.
3. Krediti za uslugu
Section titled “3. Krediti za uslugu”Ako mjesečni postotak dostupnosti padne ispod Obveze dostupnosti u bilo kojem kalendarskom mjesecu, možete biti podobni za Kredit za uslugu izračunat kao postotak naknada za Partner API koje ste platili ili trebate platiti za taj mjesec, prema sljedećoj ljestvici:
| Mjesečni postotak dostupnosti | Kredit za uslugu |
|---|---|
| Ispod 99,9% ali iznad ili jednako 99,0% | 10% |
| Ispod 99,0% ali iznad ili jednako 95,0% | 25% |
| Ispod 95,0% | 50% |
- Zahtjev za kredit. Da biste primili Kredit za uslugu, morate podnijeti pisani zahtjev Wink-u unutar trideset (30) dana od kraja kalendarskog mjeseca u kojem je došlo do nedostatka. Zahtjev mora sadržavati datume i vremena svakog incidenta Nedostupnosti za koji tražite naknadu te sve dostupne zapisnike ili dokaze. Zahtjevi podneseni nakon tog roka nisu podobni.
- Oblik kredita. Odobreni Krediti za uslugu primjenjuju se na buduće naknade za Partner API i nemaju novčanu vrijednost. Nisu povrat novca i neće se isplaćivati osim ako to ne zahtijeva važeći zakon.
- Maksimalni kredit. Ukupni Krediti za uslugu dodijeljeni za bilo koji pojedinačni kalendarski mjesec neće prelaziti 50% naknada za Partner API koje ste platili ili trebate platiti za taj mjesec.
- Jedini i isključivi lijek. Krediti za uslugu su vaš jedini i isključivi lijek za bilo kakvo neispunjavanje Obveze dostupnosti ili bilo koji drugi nedostatak dostupnosti Partner API-ja.
4. Izuzeci
Section titled “4. Izuzeci”Obveza dostupnosti i svi povezani Krediti za uslugu ne primjenjuju se, a Nedostupnost ne uključuje, bilo kakvu nedostupnost, suspenziju, degradaciju ili problem s performansama koji proizlazi iz ili se odnosi na:
- Planirano održavanje za koje je Wink dao prethodnu obavijest, pod uvjetom da je obavijest dana razumnim vremenskim razmakom unaprijed putem kanala koji Wink obično koristi za komunikaciju s korisnicima;
- Višu silu ili druge uzroke izvan razumne kontrole Wink, uključujući prirodne katastrofe, državne mjere, kvarove mreže ili komunalnih usluga te napade uskraćivanja usluge ili druge zlonamjerne napade;
- probleme uzrokovane vašim djelima ili propustima, vašom opremom, softverom ili mrežom, ili bilo kojom uslugom, proizvodom ili pružateljem treće strane koji nije pod izravnom kontrolom Wink;
- vašu zloupotrebu Usluge ili kršenje Ugovora, ovog SLA, uvjeta prihvatljive uporabe ili važećih ograničenja brzine, uključujući promet koji Wink razumno smatra pretjeranim, automatiziranu zloupotrebu ili prijevaru; i
- bilo kakvu suspenziju ili prekid vašeg pristupa pravilno izvršen pod Ugovorom, uključujući suspenziju zbog neplaćanja.
5. Podrška i ciljevi odgovora
Section titled “5. Podrška i ciljevi odgovora”Wink pruža podršku za Partner API tijekom standardnog radnog vremena, isključujući lokalne praznike. Wink će koristiti komercijalno razumna nastojanja da prizna pravilno podnesene zahtjeve za podršku unutar sljedećih ciljanih vremena odgovora, ovisno o ozbiljnosti koju dodijelite i koju Wink razumno potvrdi:
| Ozbiljnost | Opis | Ciljani početni odgovor |
|---|---|---|
| Sev 1 — Kritično | Partner API je nedostupan ili neupotrebljiv u produkciji bez zaobilaznog rješenja. | 4 sata |
| Sev 2 — Važno | Značajno oštećenje ili degradacija značajke; postoji zaobilazno rješenje. | 1 radni dan |
| Sev 3 — Manje | Opća pitanja, manji problemi ili zahtjevi za značajkama. | 2 radna dana |
Ciljana vremena odgovora opisuju kada Wink nastoji ostvariti prvi kontakt; nisu jamstva vremena rješenja. Prioritetna podrška i ciljevi temeljeni na ozbiljnosti primjenjuju se na razinama na kojima je navedeno da su uključeni.
6. Podaci i sigurnost
Section titled “6. Podaci i sigurnost”Wink održava komercijalno razumne administrativne, tehničke i organizacijske mjere dizajnirane za zaštitu povjerljivosti, integriteta i dostupnosti podataka obrađenih putem Partner API-ja, te te mjere povremeno pregledava. Obrada osobnih podataka od strane Wink regulirana je Politikom privatnosti i svim uvjetima obrade podataka u Ugovoru. Vi ostajete odgovorni za sigurnost vlastitih API vjerodajnica, za zakonitu uporabu bilo kojih podataka koje dohvatite i za pravovremeno obavještavanje Wink-a o bilo kakvom sumnjivom kompromitiranju vjerodajnica.
7. Ograničenje odgovornosti
Section titled “7. Ograničenje odgovornosti”Krediti za uslugu su jedini i isključivi lijek za bilo kakvu nedostupnost ili neispunjavanje Obveze dostupnosti i pružaju se umjesto bilo kakve druge odgovornosti koja proizlazi iz takvog neispunjavanja. Osim ako nije izričito navedeno u ovom SLA, Partner API se pruža “kakav jest”. U najvećoj mjeri dopuštenoj važećim zakonom, ukupna odgovornost Wink-a koja proizlazi iz ili se odnosi na Uslugu ograničena je kako je navedeno u Ugovoru, a Wink nije odgovoran za bilo kakvu neizravnu, slučajnu, posebnu, posljedičnu ili kaznenu štetu, niti za izgubljenu dobit, prihode, podatke ili dobar glas, čak ni ako je upozoren na mogućnost takvih šteta.
8. Trajanje, promjene i raskid
Section titled “8. Trajanje, promjene i raskid”Ovaj SLA vrijedi sve dok imate aktivnu pretplatu na Partner API na razini na kojoj je navedeno da SLA vrijedi. Wink može povremeno ažurirati ovaj SLA; materijalne promjene bit će komunicirane putem kanala koji Wink obično koristi za kontakt s korisnicima, a nastavak korištenja Partner API-ja nakon stupanja na snagu ažuriranja smatra se prihvaćanjem ažuriranog SLA. Ovaj SLA prestaje automatski prestankom ili istekom Ugovora ili vaše pretplate na Partner API. Odjeljci koji po svojoj prirodi trebaju preživjeti raskid — uključujući pravo na neiskorištene Kredite za uslugu, ograničenje odgovornosti i definicije — ostaju na snazi.