Partner API

Wink Partner API je autentifikovani, visokopropusni način za integratore da upituju rezervabilni inventar putovanja — isti onaj koji pokreće naše ugrađene vidžete i javne pretraživačke krajnje tačke, izložen kao interfejs prvog reda za programiranje. Dok su besplatni Web Components i javne pretraživačke krajnje tačke namenjeni za lagano, korisnički orijentisano ugrađivanje, Partner API je napravljen za sisteme koji pretražuju, cene i rezervišu u velikom obimu. Pristup je autentifikovan po integratoru i naplaćuje se po korišćenju, tako da plaćate samo za saobraćaj koji zaista šaljete.

Planovi i cene

Korišćenje se meri u noćenjima u hotelu: jedan hotel cenjen za jednu noć boravka — ne jedan API poziv. Pretraga koja vraća 20 hotela za 3 noći boravka predstavlja 60 noćenja u hotelu iz jednog zahteva. Pozivi za sadržaj i pretragu (pretraga destinacije i automatsko dovršavanje) su izuzetak: svaki košta jednu jedinicu po pozivu, bez obzira šta vraća. Krajnje tačke za naloge su besplatne. Cene su izvor istine za cenu.

	Besplatno	Plaćeno	Preduzeće
Cena	$0	Po korišćenju	Kontaktirajte nas
Najbolje za	Evaluaciju i integracije sa malim obimom	Plaćanje po korišćenju u velikom obimu	Prilagođeni obim i pregovarani uslovi
Jedinice mesečno	10,000	Neograničeno	Neograničeno
Vreme odgovora API-ja (P95)	—	Ispod 500 ms	Ispod 500 ms
Cena po jedinici (noćenje u hotelu)	Besplatno	$0.0001	Prilagođeno
Odgovor pri mesečnom limitu	429 do 1. u sledećem mesecu (UTC)	Naplaćuje se, nije blokirano	Po dogovoru
Ugovor o nivou usluge	—	✓	✓
Prioritetna podrška	—	✓	✓
Posvećena obuka	—	—	✓

Preuzmite API ključ · Pokrenite naplatu po korišćenju · Kontaktirajte prodaju

API referenca

Dva interfejsa služe rezervabilnom inventaru i mapiraju se na dva nivoa iznad:

• Besplatno — Consumer / Booking Engine API (REST, /api/public/**): anonimno, za pretraživače i vidžete. Pregledajte Booking Engine referencu →
• Plaćeno — Partner Integrator API (gRPC, wink.partner.v1): autentifikovano, merljivo po korišćenju, napravljeno za integraciju server-sa-serverom u velikom obimu. Pregledajte Integrator referencu →

Partner Integrator API je gRPC, ne REST. Pozivate ga generisanim klijentom preko HTTP/2 na partner.wink.travel:443, prosleđujući bearer token i nalog za koji pozivate:

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

Gornja referentna stranica dokumentuje svaku uslugu, poruku i status greške, a šema je takođe dostupna u runtime-u preko server refleksije, tako da je grpcurl, Postman i Insomnia otkrivaju bez potrebe za preuzimanjem.

Ako više volite da generišete klijenta unapred, .proto izvori su objavljeni na github.com/wink-travel/partner-api-proto.

Kako funkcionišu korišćenje i ograničenja

Besplatni nivo

Besplatni nivo je dizajniran da vam omogući da gradite, testirate i pokrećete umeren proizvodni saobraćaj bez troškova.

• Nema objavljenog ograničenja po minutu. Wink prati brzinu zahteva i može primeniti ograničenja fer korišćenja radi zaštite usluge. Ako dobijete HTTP 429 (Previše zahteva), sačekajte broj sekundi iz zaglavlja Retry-After pre ponovnog pokušaja.
• Mesečni limit — 10,000 jedinica po kalendarskom mesecu. Limit se dodeljuje po nalogu i resetuje se 1. u svakom mesecu (UTC). Kada ga dostignete, nalog koji nije prijavljen za naplatu po korišćenju prima HTTP 429 do 1. sledećeg meseca — čvrsti prekid, sa zaglavljem Retry-After i porukom koja vas poziva da se pretplatite na Plaćeni nivo. Prijavljeni nalog nastavlja da radi i naplaćuje se za korišćenje preko limita.

Besplatni nivo ne uključuje Ugovor o nivou usluge niti prioritetnu podršku.

Plaćeni nivo

Plaćeni nivo uklanja mesečni plafon i naplaćuje vas samo za ono što koristite.

• Merena noćenja u hotelu — $0.0001 po noćenju. Nema mesečnog plafona; naplaćuje se po stvarnom obimu. Wink i dalje može primenjivati ograničenja fer korišćenja radi zaštite usluge. Pretrage i pozivi inventara se naplaćuju po cenjenom noćenju; pozivi za sadržaj i pretragu naplaćuju se po jednoj jedinici, pa grupisanje zahteva smanjuje račun.

Plaćeni nivo uključuje Ugovor o nivou usluge opisan ispod — obavezu dostupnosti od 99,9% i cilj vremena odgovora P95 ispod 500 ms — i prioritetnu podršku zasnovanu na ozbiljnosti.

Ugovor o nivou usluge

Datum stupanja na snagu: 5. jul 2026 · Verzija 1.0

Ovaj Ugovor o nivou usluge (u daljem tekstu “SLA”) definiše obavezu dostupnosti, kredite za uslugu i ciljeve podrške koje Wink (“Wink”, “mi”, “nas”) pruža korisniku (“Korisnik”, “vi”) za autentifikovani Wink Partner API (u daljem tekstu “Partner API” ili “Usluga”) na nivoima gde je navedeno da SLA važi. Ovaj SLA je uključen u i uređuje se ugovorom između vas i Wink-a pod kojim pristupate Partner API-ju (u daljem tekstu “Ugovor”), i važi sve dok održavate aktivnu, plaćenu pretplatu na Partner API u dobrom stanju. Pojmovi napisani velikim slovima koji nisu definisani ovde imaju značenje dato u Ugovoru.

1. Definicije

1. “Dostupnost” znači periode tokom kojih je Partner API dostupan za prihvatanje i uspešan odgovor na pravilno formirane, autentifikovane zahteve.
2. “Nedostupnost” znači bilo koji period, izražen u minutima, tokom kojeg Partner API ne uspeva da uspešno odgovori na pravilno formirane, autentifikovane zahteve, izuzev perioda navedenih u Izuzecima u odeljku 4. Izolovane greške koje pogađaju neznatan deo zahteva same po sebi nisu Nedostupnost.
3. “Mesečni procenat dostupnosti” znači, za dati kalendarski mesec, ukupan broj minuta u tom mesecu umanjen za ukupne minute Nedostupnosti, podeljen sa ukupnim brojem minuta u tom mesecu, izražen kao procenat.
4. “Planirani radovi” znači planirani radovi na Usluzi za koje je Wink dao prethodnu najavu u skladu sa odeljkom 4.
5. “Kredit za uslugu” znači kredit, izražen kao procenat naknada koje ste platili ili treba da platite za Partner API u pogođenom kalendarskom mesecu, koji se primenjuje na buduće naknade za Partner API kao jedino i isključivo sredstvo za naknadu neuspeha u ispunjavanju obaveze dostupnosti.
6. “Vreme odgovora” znači proteklo vreme između prijema pravilno formiranog, autentifikovanog zahteva na granici usluge Wink-a i trenutka kada Wink počinje da vraća odgovor, izuzev vremena prenosa mrežom i bilo kog vremena na strani klijenta van kontrole Wink-a.

2. Obaveza dostupnosti i performansi

Wink će koristiti komercijalno razumna nastojanja da učini Partner API dostupnim sa mesečnim procentom dostupnosti od najmanje 99,9% tokom svakog kalendarskog meseca trajanja (u daljem tekstu “Obaveza dostupnosti”). Obaveza dostupnosti se meri na granici usluge Wink-a i isključuje faktore van razumne kontrole Wink-a, uključujući one opisane u odeljku 4. Sistemi za nadzor Wink-a su autoritativni izvor za merenje mesečnog procenta dostupnosti i vremena odgovora.

Wink dodatno cilja vreme odgovora na 95. percentilu (P95) ispod 500 milisekundi za uspešne, pravilno formirane, autentifikovane zahteve, merene na granici usluge Wink-a tokom svakog kalendarskog meseca (u daljem tekstu “Cilj performansi”). Cilj performansi isključuje faktore opisane u odeljku 4, zahteve koji vraćaju greške na nivou aplikacije uzrokovane samim zahtevom, i neuobičajeno velike ili složene grupne zahteve. Cilj performansi je cilj usluge; krediti za uslugu iz odeljka 3 se primenjuju na neuspehe u ispunjavanju Obaveze dostupnosti i predstavljaju jedino i isključivo sredstvo za naknadu nedostataka dostupnosti.

3. Krediti za uslugu

Ako mesečni procenat dostupnosti padne ispod Obaveze dostupnosti u bilo kom kalendarskom mesecu, možete biti podobni za Kredit za uslugu izračunat kao procenat naknada za Partner API koje ste platili ili treba da platite za taj mesec, prema sledećoj lestvici:

Mesečni procenat dostupnosti	Kredit za uslugu
Ispod 99,9% ali na ili iznad 99,0%	10%
Ispod 99,0% ali na ili iznad 95,0%	25%
Ispod 95,0%	50%

1. Podnošenje zahteva za kredit. Da biste dobili Kredit za uslugu, morate podneti pisani zahtev Wink-u u roku od trideset (30) dana od kraja kalendarskog meseca u kojem je došlo do nedostatka. Zahtev mora sadržati datume i vremena svakog incidenta Nedostupnosti za koji tražite kredit i sve dostupne zapise ili dokaze koje imate. Zahtevi podneti nakon ovog roka nisu podobni.
2. Oblik kredita. Odobreni krediti za uslugu se primenjuju na buduće naknade za Partner API i nemaju novčanu vrednost. Nisu povraćaj novca i neće biti isplaćeni osim ako to ne zahteva važeći zakon.
3. Maksimalni kredit. Ukupni krediti za uslugu dodeljeni za bilo koji pojedinačni kalendarski mesec neće prelaziti 50% naknada za Partner API koje ste platili ili treba da platite za taj mesec.
4. Jedino i isključivo sredstvo. Krediti za uslugu su vaše jedino i isključivo sredstvo za bilo kakav neuspeh Wink-a u ispunjavanju Obaveze dostupnosti ili bilo kakav drugi nedostatak dostupnosti Partner API-ja.

4. Izuzeci

Obaveza dostupnosti i bilo koji krediti za uslugu ne važe, i Nedostupnost ne uključuje, bilo kakvu nedostupnost, suspenziju, degradaciju ili problem sa performansama koji nastaju iz ili se odnose na:

1. Planirane radove za koje je Wink dao prethodnu najavu, pod uslovom da je takva najava data razumnim vremenskim periodom unapred putem kanala koji Wink obično koristi za komunikaciju sa korisnicima;
2. Višu silu ili druge uzroke van razumne kontrole Wink-a, uključujući prirodne katastrofe, državne akte, kvarove mreže ili komunalnih usluga, i napade uskraćivanja usluge ili druge zlonamerne napade;
3. probleme izazvane vašim radnjama ili propustima, vašom opremom, softverom ili mrežom, ili bilo kojom uslugom, proizvodom ili provajderom treće strane koji nije pod direktnom kontrolom Wink-a;
4. vašu zloupotrebu Usluge ili kršenje Ugovora, ovog SLA, uslova prihvatljivog korišćenja ili važećih ograničenja brzine, uključujući saobraćaj koji Wink razumno smatra prekomernim, automatizovanu zloupotrebu ili prevaru; i
5. bilo kakvu suspenziju ili prekid vašeg pristupa pravilno sproveden pod Ugovorom, uključujući suspenziju zbog neplaćanja.

5. Podrška i ciljevi odgovora

Wink pruža podršku za Partner API tokom standardnog radnog vremena, osim lokalnih državnih praznika. Wink će koristiti komercijalno razumna nastojanja da prizna pravilno podnete zahteve za podršku u sledećim ciljnim vremenima odgovora, na osnovu ozbiljnosti koju dodelite i koju Wink razumno potvrdi:

Ozbiljnost	Opis	Ciljni početni odgovor
Sev 1 — Kritično	Partner API je nedostupan ili neupotrebljiv u produkciji bez rešenja zaobilaznog puta.	4 sata
Sev 2 — Važno	Značajno oštećenje ili degradacija funkcije; postoji rešenje zaobilaznog puta.	1 radni dan
Sev 3 — Manje	Opšta pitanja, manji problemi ili zahtevi za funkcijama.	2 radna dana

Ciljna vremena odgovora opisuju kada Wink nastoji da uspostavi prvi kontakt; nisu garancije vremena rešavanja. Prioritetna podrška i ciljevi zasnovani na ozbiljnosti važe na nivoima gde je navedeno da su uključeni.

6. Podaci i bezbednost

Wink održava komercijalno razumne administrativne, tehničke i organizacione mere dizajnirane da zaštite poverljivost, integritet i dostupnost podataka obrađenih kroz Partner API, i periodično preispituje te mere. Obrada ličnih podataka od strane Wink-a uređuje se Politikom privatnosti i bilo kojim uslovima obrade podataka u Ugovoru. Vi ostajete odgovorni za bezbednost sopstvenih API akreditiva, za zakonitu upotrebu bilo kojih podataka koje preuzimate i za pravovremeno obaveštavanje Wink-a o bilo kakvom sumnjivom kompromitovanju akreditiva.

7. Ograničenje odgovornosti

Krediti za uslugu su jedino i isključivo sredstvo za bilo kakvu nedostupnost ili neuspeh u ispunjavanju Obaveze dostupnosti, i pružaju se umesto bilo kakve druge odgovornosti koja proizilazi iz takvog neuspeha. Osim ako nije izričito navedeno u ovom SLA, Partner API se pruža “kakav jeste”. U najvećoj meri dozvoljenoj važećim zakonom, ukupna odgovornost Wink-a koja proizilazi iz ili se odnosi na Uslugu ograničena je kako je navedeno u Ugovoru, i Wink nije odgovoran za bilo kakvu indirektnu, slučajnu, posebnu, posledičnu ili kaznenu štetu, niti za izgubljenu dobit, prihode, podatke ili dobar glas, čak i ako je upozoren na mogućnost takvih šteta.

8. Trajanje, izmene i raskid

Ovaj SLA važi sve dok imate aktivnu pretplatu na Partner API na nivou gde je navedeno da SLA važi. Wink može povremeno ažurirati ovaj SLA; materijalne izmene biće saopštene putem kanala koje Wink obično koristi za komunikaciju sa korisnicima, a nastavak korišćenja Partner API-ja nakon stupanja izmene na snagu predstavlja prihvatanje ažuriranog SLA. Ovaj SLA prestaje automatski prestankom ili istekom Ugovora ili vaše pretplate na Partner API. Odeljci koji po svojoj prirodi treba da opstanu nakon raskida — uključujući akumuliranu, ali neiskorišćenu podobnost za kredite za uslugu, ograničenje odgovornosti i definicije — opstaju.