Partner API

Wink Partner API to uwierzytelniony, o wyższej przepustowości sposób dla integratorów na zapytania o dostępny do rezerwacji zasób podróżniczy — ten sam zasób, który zasila nasze osadzalne widżety i publiczne punkty końcowe do przeglądania, udostępniony jako interfejs programistyczny pierwszej klasy. Gdzie darmowe Web Components i publiczne punkty końcowe do przeglądania są przeznaczone do lekkiego osadzania skierowanego do użytkownika, Partner API jest zbudowane dla systemów, które wyszukują, wyceniają i rezerwują na dużą skalę. Dostęp jest uwierzytelniany dla każdego integratora i rozliczany według zużycia, więc płacisz tylko za ruch, który faktycznie generujesz.

Plany i cennik

Zużycie mierzone jest w noclegach hotelowych: jeden hotel wyceniony na jedną noc pobytu — nie jedno wywołanie API. Wyszukiwanie, które zwraca 20 hoteli na 3 noce, to 60 noclegów hotelowych z jednego zapytania. Wywołania Content i Lookup (wyszukiwanie destynacji i autouzupełnianie) są wyjątkiem: każde kosztuje jedną jednostkę za wywołanie, niezależnie od zwróconych wyników. Punkty końcowe kont są bezpłatne. Cennik jest źródłem prawdy dla stawek.

	Darmowy	Płatny	Enterprise
Cena	0 USD	Według zużycia	Skontaktuj się z nami
Najlepszy dla	Ocena i integracje o niskim wolumenie	Płatność za rzeczywiste zużycie na dużą skalę	Niestandardowy wolumen i warunki negocjowane
Jednostki miesięcznie	10 000	Nieograniczone	Nieograniczone
Czas odpowiedzi API (P95)	—	Poniżej 500 ms	Poniżej 500 ms
Cena za jednostkę (nocleg hotelowy)	Bezpłatnie	0,0001 USD	Niestandardowa
Odpowiedź po wykorzystaniu limitu miesięcznego	429 do 1. dnia następnego miesiąca (UTC)	Rozliczane, nie blokowane	Zgodnie z umową
Umowa o Poziomie Usług	—	✓	✓
Priorytetowe wsparcie	—	✓	✓
Dedykowane wdrożenie	—	—	✓

Uzyskaj klucz API · Rozpocznij rozliczanie według zużycia · Skontaktuj się ze sprzedażą

Dokumentacja API

Dwa interfejsy obsługują dostępny do rezerwacji zasób i odpowiadają dwóm powyższym poziomom:

• Darmowy — Consumer / Booking Engine API (REST, /api/public/**): anonimowy, skierowany do przeglądarek i widżetów. Przeglądaj dokumentację Booking Engine →
• Płatny — Partner Integrator API (gRPC, wink.partner.v1): uwierzytelniony, rozliczany według zużycia, zbudowany do integracji serwer-serwer na dużą skalę. Przeglądaj dokumentację Integratora →

Partner Integrator API to gRPC, nie REST. Wywołujesz je za pomocą wygenerowanego klienta przez HTTP/2 pod adresem partner.wink.travel:443, przekazując token Bearer i konto, dla którego wykonujesz zapytanie:

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

Powyższa strona dokumentacji opisuje każdą usługę, komunikat i status błędu, a schemat jest również dostępny w czasie działania przez refleksję serwera, więc grpcurl, Postman i Insomnia mogą go odkryć bez konieczności pobierania czegokolwiek.

Jeśli wolisz wygenerować klienta wcześniej, pliki źródłowe .proto są opublikowane na github.com/wink-travel/partner-api-proto.

Jak działają zużycie i limity

Darmowy poziom

Darmowy poziom jest zaprojektowany, aby pozwolić Ci budować, testować i obsługiwać umiarkowany ruch produkcyjny bez kosztów.

• Brak opublikowanego limitu na minutę. Wink monitoruje tempo zapytań i może stosować limity fair-use, aby chronić usługę. Jeśli otrzymasz HTTP 429 (Too Many Requests), poczekaj liczbę sekund podaną w nagłówku Retry-After przed ponowną próbą.
• Miesięczny limit — 10 000 jednostek na miesiąc kalendarzowy. Limit jest przyznawany na konto i resetuje się 1. dnia każdego miesiąca (UTC). Po jego przekroczeniu konto, które nie jest zapisane do rozliczania według zużycia, otrzymuje HTTP 429 do 1. dnia następnego miesiąca — twardy stop, z nagłówkiem Retry-After i komunikatem zachęcającym do subskrypcji płatnego poziomu. Konto zapisane działa dalej i jest rozliczane za zużycie ponad limit.

Darmowy poziom nie obejmuje Umowy o Poziomie Usług ani priorytetowego wsparcia.

Płatny poziom

Płatny poziom usuwa miesięczny limit i rozlicza Cię tylko za to, co wykorzystasz.

• Mierzone noclegi hotelowe — 0,0001 USD za nocleg hotelowy. Nie ma miesięcznego limitu; rozliczany jesteś według faktycznego wolumenu. Wink może nadal stosować limity fair-use, aby chronić usługę. Wywołania wyszukiwania i zasobów rozliczane są za każdą wycenioną nocleg hotelowy; wywołania Content i Lookup rozliczane są po jednej jednostce każde, więc grupowanie zapytań obniża rachunek.

Płatny poziom obejmuje Umowę o Poziomie Usług opisaną poniżej — zobowiązanie do 99,9% dostępności i cel czasu odpowiedzi P95 poniżej 500 ms — oraz priorytetowe wsparcie oparte na stopniu ważności.

Umowa o Poziomie Usług

Data wejścia w życie: 5 lipca 2026 · Wersja 1.0

Niniejsza Umowa o Poziomie Usług („SLA”) określa zobowiązanie do dostępności, kredyty serwisowe oraz cele wsparcia, które Wink („Wink”, „my”, „nas”) zapewnia klientowi („Klient”, „Ty”) dla uwierzytelnionego Wink Partner API („Partner API” lub „Usługa”) na poziomach, dla których SLA jest określona jako obowiązująca. Niniejsza SLA jest włączona do i regulowana przez umowę między Tobą a Wink, na podstawie której uzyskujesz dostęp do Partner API („Umowa”), i obowiązuje tak długo, jak utrzymujesz aktywną, płatną subskrypcję Partner API w dobrym stanie. Terminologia pisana wielką literą, która nie jest tutaj zdefiniowana, ma znaczenie nadane jej w Umowie.

1. Definicje

1. „Dostępność” oznacza okresy, w których Partner API jest dostępne do przyjmowania i pomyślnego odpowiadania na poprawnie sformułowane, uwierzytelnione zapytania.
2. „Przestój” oznacza dowolny okres, mierzony w minutach, podczas którego Partner API nie odpowiada pomyślnie na poprawnie sformułowane, uwierzytelnione zapytania, z wyłączeniem okresów określonych w Wyłączeniach w Sekcji 4. Pojedyncze błędy dotyczące nieistotnej części zapytań nie są same w sobie Przestojem.
3. „Miesięczny procent dostępności” oznacza, dla danego miesiąca kalendarzowego, całkowitą liczbę minut w tym miesiącu minus całkowitą liczbę minut przestoju, podzieloną przez całkowitą liczbę minut w tym miesiącu, wyrażoną w procentach.
4. „Planowana konserwacja” oznacza zaplanowaną konserwację Usługi, o której Wink poinformował z wyprzedzeniem zgodnie z Sekcją 4.
5. „Kredyt serwisowy” oznacza kredyt, obliczany jako procent opłat zapłaconych lub należnych przez Ciebie za Partner API w dotkniętym miesiącu kalendarzowym, który jest stosowany jako jedyne i wyłączne zadośćuczynienie za niespełnienie zobowiązania dotyczącego dostępności.
6. „Czas odpowiedzi” oznacza czas, jaki upływa od momentu otrzymania przez Wink poprawnie sformułowanego, uwierzytelnionego zapytania na granicy usługi Wink do momentu, w którym Wink zaczyna zwracać odpowiedź, z wyłączeniem czasu przesyłu sieciowego i wszelkiego czasu po stronie klienta poza kontrolą Wink.

2. Zobowiązanie do dostępności i wydajności

Wink dołoży komercyjnie uzasadnionych starań, aby Partner API było dostępne na poziomie Miesięcznego procentu dostępności co najmniej 99,9% w każdym miesiącu kalendarzowym okresu obowiązywania („Zobowiązanie do dostępności”). Zobowiązanie do dostępności jest mierzone na granicy usługi Wink i wyklucza czynniki poza rozsądną kontrolą Wink, w tym opisane w Sekcji 4. Systemy monitorujące Wink są autorytatywnym źródłem pomiaru Miesięcznego procentu dostępności i Czasu odpowiedzi.

Wink dodatkowo celuje w czas odpowiedzi na poziomie 95. percentyla (P95) poniżej 500 milisekund dla pomyślnych, poprawnie sformułowanych, uwierzytelnionych zapytań, mierzonego na granicy usługi Wink w każdym miesiącu kalendarzowym („Cel wydajności”). Cel wydajności wyklucza czynniki opisane w Sekcji 4, zapytania zwracające błędy na poziomie aplikacji spowodowane samym zapytaniem oraz wyjątkowo duże lub złożone zapytania zbiorcze. Cel wydajności jest celem usługi; Kredyty serwisowe w Sekcji 3 dotyczą niespełnienia Zobowiązania do dostępności i są jedynym i wyłącznym zadośćuczynieniem za niedostępność.

3. Kredyty serwisowe

Jeśli Miesięczny procent dostępności spadnie poniżej Zobowiązania do dostępności w dowolnym miesiącu kalendarzowym, możesz być uprawniony do Kredytu serwisowego obliczanego jako procent opłat za Partner API zapłaconych lub należnych przez Ciebie za ten miesiąc, według następującej skali:

Miesięczny procent dostępności	Kredyt serwisowy
Poniżej 99,9%, ale co najmniej 99,0%	10%
Poniżej 99,0%, ale co najmniej 95,0%	25%
Poniżej 95,0%	50%

1. Zgłaszanie roszczenia. Aby otrzymać Kredyt serwisowy, musisz złożyć pisemne roszczenie do Wink w ciągu trzydziestu (30) dni od końca miesiąca kalendarzowego, w którym wystąpiło niedociągnięcie. Roszczenie musi zawierać daty i godziny każdego incydentu przestoju, którego dotyczy, oraz wszelkie dostępne logi lub dowody. Roszczenia złożone po tym terminie nie będą rozpatrywane.
2. Forma kredytu. Zatwierdzone Kredyty serwisowe są stosowane jako potrącenie z przyszłych opłat za Partner API i nie mają wartości pieniężnej. Nie są zwrotami i nie będą wypłacane, chyba że wymaga tego obowiązujące prawo.
3. Maksymalny kredyt. Łączna wartość Kredytów serwisowych przyznanych za pojedynczy miesiąc kalendarzowy nie przekroczy 50% opłat za Partner API zapłaconych lub należnych przez Ciebie za ten miesiąc.
4. Jedyna i wyłączna rekompensata. Kredyty serwisowe są Twoim jedynym i wyłącznym zadośćuczynieniem za jakiekolwiek niespełnienie Zobowiązania do dostępności lub inne niedostępności Partner API.

4. Wyłączenia

Zobowiązanie do dostępności i wynikające z niego Kredyty serwisowe nie mają zastosowania, a Przestój nie obejmuje żadnej niedostępności, zawieszenia, degradacji lub problemu z wydajnością wynikającego z lub związanego z:

1. Planowaną konserwacją, o której Wink poinformował z wyprzedzeniem, pod warunkiem, że powiadomienie zostało przekazane z odpowiednim wyprzedzeniem za pośrednictwem kanału, którego Wink zwykle używa do komunikacji z klientami;
2. zdarzeniami siły wyższej lub innymi przyczynami poza rozsądną kontrolą Wink, w tym klęskami żywiołowymi, działaniami rządu, awariami sieci lub mediów, oraz atakami typu denial-of-service lub innymi złośliwymi atakami;
3. problemami spowodowanymi przez Twoje działania lub zaniechania, Twój sprzęt, oprogramowanie lub sieć, albo przez jakąkolwiek usługę, produkt lub dostawcę stron trzecich niebędących pod bezpośrednią kontrolą Wink;
4. Twoim nadużyciem Usługi lub naruszeniem Umowy, niniejszej SLA, warunków akceptowalnego użytkowania lub obowiązujących limitów, w tym ruchem, który Wink uzna za nadmierny, automatycznym nadużyciem lub oszustwem; oraz
5. wszelkimi zawieszeniami lub zakończeniem Twojego dostępu prawidłowo dokonanymi na podstawie Umowy, w tym zawieszeniem za brak płatności.

5. Wsparcie i cele odpowiedzi

Wink zapewnia wsparcie dla Partner API w standardowych godzinach pracy, z wyłączeniem lokalnych dni świątecznych. Wink dołoży komercyjnie uzasadnionych starań, aby potwierdzić otrzymanie poprawnie zgłoszonych zgłoszeń wsparcia w następujących docelowych czasach odpowiedzi, w zależności od przypisanego przez Ciebie stopnia ważności i potwierdzonego przez Wink:

Ważność	Opis	Docelowy czas pierwszej odpowiedzi
Sev 1 — Krytyczny	Partner API jest niedostępne lub nieużywalne w produkcji bez obejścia.	4 godziny
Sev 2 — Poważny	Znaczące ograniczenie lub degradacja funkcji; istnieje obejście.	1 dzień roboczy
Sev 3 — Pomniejszy	Ogólne pytania, drobne problemy lub prośby o funkcje.	2 dni robocze

Docelowe czasy odpowiedzi opisują moment, w którym Wink zamierza nawiązać pierwszy kontakt; nie są gwarancją czasu rozwiązania. Priorytetowe wsparcie i cele oparte na ważności obowiązują na poziomach, gdzie są one uwzględnione.

6. Dane i bezpieczeństwo

Wink utrzymuje komercyjnie uzasadnione środki administracyjne, techniczne i organizacyjne mające na celu ochronę poufności, integralności i dostępności danych przetwarzanych przez Partner API oraz okresowo je przegląda. Przetwarzanie danych osobowych przez Wink jest regulowane przez Politykę prywatności oraz wszelkie warunki przetwarzania danych zawarte w Umowie. Pozostajesz odpowiedzialny za zabezpieczenie własnych poświadczeń API, za legalne wykorzystanie wszelkich pobranych danych oraz za niezwłoczne powiadomienie Wink o podejrzeniu naruszenia poświadczeń.

7. Ograniczenie odpowiedzialności

Kredyty serwisowe są jedynym i wyłącznym zadośćuczynieniem za jakąkolwiek niedostępność lub niespełnienie Zobowiązania do dostępności i są udzielane zamiast jakiejkolwiek innej odpowiedzialności wynikającej z takiego niedociągnięcia. Z wyjątkiem wyraźnie określonych w niniejszej SLA, Partner API jest dostarczane „tak jak jest”. W maksymalnym zakresie dozwolonym przez obowiązujące prawo, łączna odpowiedzialność Wink wynikająca z lub związana z Usługą jest ograniczona zgodnie z postanowieniami Umowy, a Wink nie ponosi odpowiedzialności za jakiekolwiek szkody pośrednie, przypadkowe, specjalne, następcze lub karne, ani za utracone zyski, przychody, dane lub dobrą wolę, nawet jeśli został poinformowany o możliwości takich szkód.

8. Okres obowiązywania, zmiany i zakończenie

Niniejsza SLA obowiązuje tak długo, jak masz aktywną subskrypcję Partner API na poziomie, dla którego SLA jest określona jako obowiązująca. Wink może od czasu do czasu aktualizować tę SLA; istotne zmiany będą komunikowane za pośrednictwem kanału, którego Wink zwykle używa do kontaktu z klientami, a dalsze korzystanie z Partner API po wejściu w życie aktualizacji oznacza akceptację zaktualizowanej SLA. Niniejsza SLA wygasa automatycznie wraz z rozwiązaniem lub wygaśnięciem Umowy lub Twojej subskrypcji Partner API. Sekcje, które ze swej natury powinny przetrwać zakończenie — w tym nabyte, ale niezgłoszone uprawnienia do Kredytów serwisowych, ograniczenie odpowiedzialności i definicje — pozostają w mocy.