Partner API

Wink Partner API je overjen, z večjo prepustnostjo namenjen način za integratorje, da poizvedujejo o rezervabilnem potovalnem inventarju — isti vir, ki poganja naše vdelane pripomočke in javne brskalne končne točke, predstavljen kot programski vmesnik prvega razreda. Medtem ko so brezplačni spletni komponenti in javne brskalne končne točke namenjene lahkemu, uporabniku prijaznemu vdelovanju, je Partner API zasnovan za sisteme, ki iščejo, cenijo in rezervirajo v velikem obsegu. Dostop je overjen za vsakega integratorja posebej in se zaračunava glede na uporabo, zato plačate le za promet, ki ga dejansko pošljete.

Paketi in cene

Uporaba se meri v nočitvah v hotelih: en hotel ocenjen za eno noč bivanja — ne ena klic API. Iskanje, ki vrne 20 hotelov za 3 nočitve, pomeni 60 nočitev v hotelih iz enega samega zahtevka. Klici za vsebino in iskanje (iskanje destinacije in samodejno dopolnjevanje) so izjema: vsak stane eno enoto na klic, ne glede na rezultat. Končne točke za račun so brezplačne. Cenik je vir resnice za ceno.

	Brezplačno	Plačljivo	Podjetniško
Cena	0 $	Glede na uporabo	Kontaktirajte nas
Najbolj primerno za	Oceno in integracije z nizkim prometom	Plačilo po uporabi pri velikem obsegu	Prilagojen obseg in pogajani pogoji
Enote na mesec	10.000	Neomejeno	Neomejeno
Čas odziva API (P95)	—	Pod 500 ms	Pod 500 ms
Cena na enoto (nočitev v hotelu)	Brezplačno	0,0001 $	Po dogovoru
Odziv po mesečni kvoti	429 do 1. v naslednjem mesecu (UTC)	Zaračunano, ne blokirano	Po dogovoru
Dogovor o ravni storitve	—	✓	✓
Prednostna podpora	—	✓	✓
Namenjena uvedba	—	—	✓

Pridobite API ključ · Začnite merjeno obračunavanje · Kontaktirajte prodajo

Referenca API

Dve površini služita rezervabilnemu inventarju in se ujemata z zgornjima dvema nivojema:

• Brezplačno — Consumer / Booking Engine API (REST, /api/public/**): anonimno, namenjeno brskalniku in pripomočkom. Prebrskajte Booking Engine referenco →
• Plačljivo — Partner Integrator API (gRPC, wink.partner.v1): overjeno, merjeno glede na uporabo, zasnovano za integracijo strežnik-strežnik v velikem obsegu. Prebrskajte Integrator referenco →

Partner Integrator API je gRPC, ne REST. Kličete ga z generiranim odjemalcem prek HTTP/2 na partner.wink.travel:443, pri čemer posredujete žeton nosilca in račun, za katerega kličete:

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

Referenčna stran zgoraj dokumentira vsako storitev, sporočilo in status napake, shema pa je na voljo tudi v času izvajanja prek odboja strežnika, zato jo grpcurl, Postman in Insomnia odkrijejo brez prenosa.

Če raje generirate odjemalca vnaprej, so izvorne datoteke .proto objavljene na github.com/wink-travel/partner-api-proto.

Kako deluje uporaba in omejitve

Brezplačni nivo

Brezplačni nivo je zasnovan tako, da vam omogoči gradnjo, testiranje in zmerno produkcijsko uporabo brez stroškov.

• Ni objavljene omejitve na minuto. Wink spremlja stopnje zahtevkov in lahko uporabi omejitve poštene uporabe za zaščito storitve. Če prejmete HTTP 429 (Preveč zahtevkov), počakajte število sekund, navedeno v glavi Retry-After, preden poskusite znova.
• Mesečna kvota — 10.000 enot na koledarski mesec. Kvota je dodeljena na račun in se ponastavi 1. v vsakem mesecu (UTC). Ko jo dosežete, račun, ki ni vključen v obračun po uporabi, prejme HTTP 429 do 1. naslednjega meseca — trda zaustavitev, z glavo Retry-After in sporočilom, ki vas vabi k naročnini na plačljivi nivo. Vključen račun deluje naprej in se zaračunava za uporabo nad kvoto.

Brezplačni nivo ne vključuje dogovora o ravni storitve ali prednostne podpore.

Plačljivi nivo

Plačljivi nivo odstrani mesečno zgornjo mejo in vam zaračunava le za dejansko uporabo.

• Merjene nočitve v hotelih — 0,0001 $ na nočitev v hotelu. Ni mesečne zgornje meje; zaračunava se glede na dejanski obseg. Wink lahko še vedno uporabi omejitve poštene uporabe za zaščito storitve. Klici iskanja in inventarja se zaračunavajo na nočitev v hotelu; klici za vsebino in iskanje pa po eni enoti na klic, zato združevanje zahtevkov znižuje račun.

Plačljivi nivo vključuje dogovor o ravni storitve, opisan spodaj — zavezo 99,9 % razpoložljivosti in cilj odzivnega časa P95 pod 500 ms — ter prednostno, glede na resnost, podporo.

Dogovor o ravni storitve

Uveljavitveni datum: 5. julij 2026 · Različica 1.0

Ta dogovor o ravni storitve (SLA) določa zavezo glede razpoložljivosti, storitvene kredite in cilje podpore, ki jih Wink (“Wink”, “mi”, “nas”) zagotavlja stranki (“Stranka”, “vi”) za overjeni Wink Partner API (“Partner API” ali “Storitev”) na nivojih, kjer je navedeno, da SLA velja. Ta SLA je vključen v in urejen z dogovorom med vami in Wink, na podlagi katerega dostopate do Partner API (»Dogovor«), in velja, dokler imate aktivno, plačano naročnino na Partner API v dobrem stanju. Velike začetnice, ki niso definirane tukaj, imajo pomen, določen v Dogovoru.

1. Definicije

1. “Razpoložljivost” pomeni obdobja, v katerih je Partner API na voljo za sprejem in uspešen odgovor na pravilno oblikovane, overjene zahtevke.
2. “Nedosegljivost” pomeni katerokoli obdobje, merjeno v minutah, v katerem Partner API ne uspe uspešno odgovoriti na pravilno oblikovane, overjene zahtevke, z izjemo obdobij, ki so izključena v 4. poglavju. Izolirane napake, ki vplivajo na nepomemben delež zahtevkov, same po sebi niso nedosegljivost.
3. “Mesečni odstotek razpoložljivosti” pomeni za določen koledarski mesec skupno število minut v tem mesecu minus skupno število minut nedosegljivosti, deljeno s skupnim številom minut v tem mesecu, izraženo v odstotkih.
4. “Načrtovano vzdrževanje” pomeni načrtovano vzdrževanje storitve, za katerega je Wink predhodno obvestil v skladu s 4. poglavjem.
5. “Storitveni kredit” pomeni kredit, izračunan kot odstotek plačanih ali plačljivih pristojbin za Partner API v prizadetem koledarskem mesecu, ki se uporabi kot edino in izključujoče pravno sredstvo za neizpolnitev zaveze glede razpoložljivosti.
6. “Čas odziva” pomeni čas, ki preteče od prejema pravilno oblikovanega, overjenega zahtevka na mejni točki storitve Wink do trenutka, ko Wink začne vračati odgovor, brez upoštevanja omrežnega prenosa in časa na strani odjemalca, ki ni pod nadzorom Wink.

2. Zaveza glede razpoložljivosti in zmogljivosti

Wink bo uporabil komercialno razumne napore, da bo Partner API na voljo z mesečnim odstotkom razpoložljivosti najmanj 99,9 % v vsakem koledarskem mesecu trajanja (»Zaveza glede razpoložljivosti«). Zaveza glede razpoložljivosti se meri na mejni točki storitve Wink in izključuje dejavnike, ki niso pod razumljivim nadzorom Wink, vključno s tistimi, opisanimi v 4. poglavju. Winkovi sistemi za spremljanje so avtoritativni vir za merjenje mesečnega odstotka razpoložljivosti in časa odziva.

Wink dodatno cilja na 95. percentil (P95) časa odziva pod 500 milisekund za uspešne, pravilno oblikovane, overjene zahtevke, merjeno na mejni točki storitve Wink v vsakem koledarskem mesecu (»Cilj zmogljivosti«). Cilj zmogljivosti izključuje dejavnike, opisane v 4. poglavju, zahtevke, ki vračajo napake na ravni aplikacije zaradi samega zahtevka, in nenavadno velike ali kompleksne serijske zahtevke. Cilj zmogljivosti je cilj storitve; storitveni krediti v 3. poglavju veljajo za neizpolnitev Zaveze glede razpoložljivosti in so edino in izključujoče pravno sredstvo za pomanjkljivosti razpoložljivosti.

3. Storitveni krediti

Če mesečni odstotek razpoložljivosti pade pod Zavezo glede razpoložljivosti v katerem koli koledarskem mesecu, ste lahko upravičeni do storitvenega kredita, izračunanega kot odstotek pristojbin za Partner API, ki ste jih plačali ali jih morate plačati za ta mesec, po naslednji lestvici:

Mesečni odstotek razpoložljivosti	Storitveni kredit
Pod 99,9 %, a vsaj 99,0 %	10 %
Pod 99,0 %, a vsaj 95,0 %	25 %
Pod 95,0 %	50 %

1. Uveljavljanje kredita. Za prejem storitvenega kredita morate Wink poslati pisno zahtevo v roku trideset (30) dni po koncu koledarskega meseca, v katerem je prišlo do pomanjkljivosti. Zahteva mora vsebovati datume in ure vsakega dogodka nedosegljivosti, ki ga uveljavljate, ter morebitne podpirajoče dnevnike ali dokaze, ki so vam razumno na voljo. Zahteve, oddane po tem roku, niso upravičene.
2. Oblika kredita. Odobreni storitveni krediti se uporabijo za prihodnje pristojbine za Partner API in nimajo denarne vrednosti. Niso vračila in ne bodo izplačani, razen če to zahteva veljavna zakonodaja.
3. Največji kredit. Skupni storitveni krediti, dodeljeni za kateri koli posamezen koledarski mesec, ne bodo presegli 50 % pristojbin za Partner API, ki ste jih plačali ali jih morate plačati za ta mesec.
4. Edino in izključujoče pravno sredstvo. Storitveni krediti so vaše edino in izključujoče pravno sredstvo za kakršnokoli neizpolnitev Zaveze glede razpoložljivosti ali druge pomanjkljivosti razpoložljivosti Partner API.

4. Izključitve

Zaveza glede razpoložljivosti in morebitni storitveni krediti ne veljajo za, in nedosegljivost ne vključuje, kakršnokoli nedosegljivost, začasno ustavitev, poslabšanje ali težave z zmogljivostjo, ki izhajajo iz ali so povezane z:

1. Načrtovanim vzdrževanjem, za katerega je Wink predhodno obvestil, če je bilo obvestilo dano v razumljivem času vnaprej prek kanala, ki ga Wink običajno uporablja za komunikacijo s strankami;
2. Višjo silo ali drugimi vzroki, ki niso pod razumljivim nadzorom Wink, vključno z naravnimi nesrečami, ukrepi oblasti, izpadi omrežja ali komunalnih storitev ter napadi z zavračanjem storitve ali drugimi zlonamernimi napadi;
3. težavami, ki jih povzročijo vaša dejanja ali opustitve, vaša oprema, programska oprema ali omrežje, ali katera koli tretja oseba, storitev, izdelek ali ponudnik, ki ni pod neposrednim nadzorom Wink;
4. vašo zlorabo storitve ali kršitvijo Dogovora, tega SLA, pogojev sprejemljive uporabe ali veljavnih omejitev hitrosti, vključno s prometom, za katerega Wink upravičeno meni, da je pretiran, avtomatizirano zlorabo ali goljufivim; in
5. kakršnokoli začasno ustavitev ali prenehanje vašega dostopa, ki je pravilno izvedeno v skladu z Dogovorom, vključno z začasno ustavitvijo zaradi neplačila.

5. Podpora in cilji odziva

Wink nudi podporo za Partner API med običajnimi delovnimi urami, z izjemo lokalnih praznikov. Wink bo uporabil komercialno razumne napore, da bo potrdil pravilno oddane zahteve za podporo v naslednjih ciljanih časih odziva, glede na resnost, ki jo določite in jo Wink razumljivo potrdi:

Resnost	Opis	Ciljni začetni odziv
Sev 1 — Kritično	Partner API je nedosegljiv ali neuporaben v produkciji brez rešitve.	4 ure
Sev 2 — Glavno	Pomembna funkcija je okrnjena ali poslabšana; rešitev obstaja.	1 delovni dan
Sev 3 — Manjše	Splošna vprašanja, manjše težave ali zahteve za funkcije.	2 delovna dneva

Ciljni časi odziva opisujejo, kdaj Wink namerava vzpostaviti prvi stik; niso zagotovila za čas rešitve. Prednostna podpora in cilji glede na resnost veljajo na nivojih, kjer je navedeno, da so vključeni.

6. Podatki in varnost

Wink vzdržuje komercialno razumne upravne, tehnične in organizacijske ukrepe, namenjene zaščiti zaupnosti, celovitosti in razpoložljivosti podatkov, obdelanih prek Partner API, in te ukrepe občasno pregleduje. Obravnava osebnih podatkov Wink je urejena s Politiko zasebnosti in morebitnimi pogoji za obdelavo podatkov v Dogovoru. Odgovorni ste za varovanje lastnih poverilnic API, za zakonito uporabo vseh pridobljenih podatkov in za pravočasno obveščanje Wink o morebitni sumljivi zlorabi poverilnic.

7. Omejitev odgovornosti

Storitveni krediti so edino in izključujoče pravno sredstvo za kakršnokoli nedosegljivost ali neizpolnitev Zaveze glede razpoložljivosti in se zagotavljajo namesto kakršnekoli druge odgovornosti, ki izhaja iz take neizpolnitve. Razen če je v tem SLA izrecno navedeno drugače, je Partner API na voljo “kot je”. V največji meri, ki jo dovoljuje veljavna zakonodaja, je skupna odgovornost Wink, ki izhaja iz ali je povezana s Storitevjo, omejena, kot je določeno v Dogovoru, in Wink ni odgovoren za kakršnokoli posredno, naključno, posebno, posledično ali kazensko škodo ali za izgubljeni dobiček, prihodke, podatke ali ugled, tudi če je bil obveščen o možnosti takšne škode.

8. Trajanje, spremembe in prenehanje

Ta SLA velja, dokler imate aktivno naročnino na Partner API na nivoju, kjer je navedeno, da SLA velja. Wink lahko to SLA občasno posodobi; pomembne spremembe bodo sporočene prek kanala, ki ga Wink običajno uporablja za dosego strank, nadaljnja uporaba Partner API po uveljavitvi posodobitve pa pomeni sprejetje posodobljenega SLA. Ta SLA preneha veljati samodejno ob prenehanju ali poteku Dogovora ali vaše naročnine na Partner API. Poglavja, ki po svoji naravi preživijo prenehanje — vključno z upravičenostjo do neizkoriščenih storitvenih kreditov, omejitvijo odgovornosti in definicijami — ostanejo v veljavi.