Szybki start
Ten przewodnik przeprowadzi Cię od zera do działającej integracji w około 30 minut. Na końcu będziesz mieć:
- ceny hoteli na żywo w mieście, z Partner API,
- link do rezerwacji, który przypisuje rezerwacje do Twojego konta,
- testową rezerwację oraz webhook informujący o jej dokonaniu.
Wszystko odbywa się na środowisku testowym (staging), naszym środowisku testowym. Nie musisz prosić nas o dostęp, a przejście do produkcji później nie wymaga zatwierdzenia.
Czy to odpowiedni przewodnik dla Ciebie?
Dział zatytułowany „Czy to odpowiedni przewodnik dla Ciebie?”| Chcesz… | Zacznij tutaj |
|---|---|
| Pokazać hotele w swojej aplikacji, na stronie lub w produkcie AI i kierować podróżnych do rezerwacji, zarabiając prowizję | Ten przewodnik |
| Rezerwować w imieniu swoich klientów jako licencjonowana agencja turystyczna | Ten przewodnik do Kroku 5, potem Rezerwacje jako agencja turystyczna |
| Osadzić rezerwowane hotele bez pisania integracji | Web Components |
| Pozwolić agentowi AI wyszukiwać i rezerwować | MCP Servers oraz Agentic Payments |
| Podłączyć channel managera lub PMS | Dodaj swojego channel managera |
Jak to działa
Dział zatytułowany „Jak to działa”Używasz Partner API, aby znaleźć hotele i ich ceny na żywo. Każdy hotel ma stabilny urlName. Zamieniasz go na link do Wink Booking Engine, book.wink.travel, zawierający Twoje identyfikatory. Podróżny dokonuje rezerwacji i płatności tam, a rezerwacja jest przypisywana do Twojego konta.
Przed rozpoczęciem
Dział zatytułowany „Przed rozpoczęciem”Będziesz potrzebować:
grpcurl, lub Postman albo Insomnia. Partner API to gRPC, nie REST.curl.
Krok 1: Utwórz konto na środowisku testowym
Dział zatytułowany „Krok 1: Utwórz konto na środowisku testowym”Środowisko testowe jest całkowicie oddzielone od produkcji, z własnymi loginami i kontami.
-
Przejdź do staging-app.wink.travel, kliknij
Sign-In / Registeri zarejestruj się. -
Kliknij
Accountsw lewym pasku bocznym, potemCreatei wybierz I am an Affiliate. Rezerwacje, które wyślesz, będą przypisane do tego konta. Zobacz Utwórz konto.
Krok 2: Utwórz aplikację
Dział zatytułowany „Krok 2: Utwórz aplikację”Aplikacja nada Twojemu kodowi dane uwierzytelniające.
-
Na karcie konta kliknij
Actions>Manage account, a następnie zakładkęApplications. -
Kliknij
Create new application, nadaj jej nazwę i wybierz Machine-to-machine jako typ klienta. -
W sekcji scopes wybierz Inventory & rates (odczyt). Partner API wymaga
inventory.read. -
Kliknij
Create applicationi skopiuj Client ID oraz Client secret. Sekret jest pokazany tylko raz i nie można go później odzyskać.
Zobacz Applications dla innych typów klientów i zakresów.
Krok 3: Pobierz token dostępu
Dział zatytułowany „Krok 3: Pobierz token dostępu”curl -X POST https://staging-iam.wink.travel/oauth2/token \ -H "Content-Type: application/x-www-form-urlencoded" \ -d "grant_type=client_credentials" \ -d "client_id=<YOUR_CLIENT_ID>" \ -d "client_secret=<YOUR_CLIENT_SECRET>" \ -d "scope=inventory.read"Zapisz access_token z odpowiedzi:
export WINK_TOKEN=<access_token>Tokeny wygasają. W swoim kodzie pozwól bibliotece OAuth2 pobierać i odnawiać je automatycznie. Zobacz Authentication.
Jeśli żądanie tokena zostanie odrzucone, odpowiedź to JSON z kodem error:
error | Status HTTP | Typowa przyczyna |
|---|---|---|
invalid_client | 401 | Błędny client ID lub secret, albo użycie danych produkcyjnych na staging-iam |
invalid_scope | 400 | Żądanie zawiera zakres, którego aplikacja nie ma |
unauthorized_client | 400 | Aplikacja nie ma prawa używać grant client_credentials |
invalid_request | 400 | Brak wymaganego parametru, np. gdy ciało jest JSON zamiast formularza |
Krok 4: Znajdź ID swojego konta
Dział zatytułowany „Krok 4: Znajdź ID swojego konta”Każde wywołanie Partner API wskazuje konto, na które działasz, w nagłówku managing-entity-id. Wylistuj konta, na które Twój token ma uprawnienia:
grpcurl -H "authorization: Bearer $WINK_TOKEN" \ -d '{}' \ staging-partner.wink.travel:443 wink.partner.v1.Accounts/ListAccountsSkopiuj accountId konta afilianta z Kroku 1:
export WINK_ACCOUNT_ID=<accountId>Krok 5: Wyszukaj hotele w mieście
Dział zatytułowany „Krok 5: Wyszukaj hotele w mieście”Środowisko testowe ma testowe hotele z dostępnością w Bangkoku, więc to wyszukiwanie używa jego slug bangkok-thailand:
grpcurl -H "authorization: Bearer $WINK_TOKEN" \ -H "managing-entity-id: $WINK_ACCOUNT_ID" \ -d '{ "urlName": "bangkok-thailand", "userSession": { "itinerary": { "startDate": "2026-12-01", "nights": 2, "room": { "adults": 2 } }, "currencyCode": "USD", "languageCode": "en" } }' \ staging-partner.wink.travel:443 wink.partner.v1.Search/SearchByCityUżyj daty zameldowania w przyszłości; data z przeszłości zostanie odrzucona. Każdy wynik zawiera:
name,starRatingiheroImageUrl, wystarczające do pokazania wiersza wyniku,roomTypes, oferty na żywo, najtańszy pokój pierwszy,urlName, slug potrzebny do linku rezerwacji.
Ceny są liczbami całkowitymi w jednostkach podrzędnych: podziel przez 10 do potęgi currencyExponent z odpowiedzi (2 dla USD, więc 12500 to 125,00 USD).
Nie znasz sluga miasta? Rozwiąż go za pomocą wink.partner.v1.Lookup/Search. Pełną zawartość obiektu uzyskasz przez serwis Content. Dokumentacja Partner API opisuje każde wywołanie.
Krok 6: Zbuduj link do rezerwacji
Dział zatytułowany „Krok 6: Zbuduj link do rezerwacji”https://staging-book.wink.travel/hotel/<urlName>?client-id=<YOUR_CLIENT_ID>&configuration-id=<YOUR_CUSTOMIZATION_ID><urlName>tourlNamehotelu z Kroku 5.client-idto Client ID Twojej aplikacji z Kroku 2.configuration-idto Twój ID personalizacji:Manage account>Customizations. Personalizacja ustawia też branding, domyślny język i walutę na stronie rezerwacji.
Przekaż wyszukiwanie podróżnego
Dział zatytułowany „Przekaż wyszukiwanie podróżnego”Dodaj daty, gości, język i walutę podróżnego do tego samego linku, aby strona hotelu otworzyła się z wypełnionymi danymi:
https://staging-book.wink.travel/hotel/<urlName>?client-id=<YOUR_CLIENT_ID>&configuration-id=<YOUR_CUSTOMIZATION_ID>&sd=2027-03-14&n=2&rc=a2&l=en&c=USD| Parametr | Znaczenie | Przykład |
|---|---|---|
sd | Data zameldowania | sd=2027-03-14 |
n lub ed | Liczba nocy lub data wymeldowania | n=2 lub ed=2027-03-16 |
rc | Goście na pokój | rc=a2 (2 dorosłych) |
l | Język wyświetlania | l=en |
c | Waluta wyświetlania | c=USD |
p | Kod promocyjny | p=ABC123 |
Te parametry nadpisują domyślne ustawienia personalizacji. Przewodnik po przycisku Book Now opisuje pełny format rc, w tym dzieci i kilka pokoi.
Link otwiera stronę hotelu; nie może wstępnie wybrać pokoju ani ceny. Podróżny wybiera pokój na stronie hotelu, po cenie na żywo.
Zobacz Bezpośrednie linkowanie jeśli chcesz linkować do strony głównej silnika rezerwacji zamiast pojedynczego hotelu.
Krok 7: Zrób testową rezerwację
Dział zatytułowany „Krok 7: Zrób testową rezerwację”Otwórz swój link, wybierz daty i pokój, i dokonaj płatności za pomocą testowej karty Stripe, np. 4242 4242 4242 4242 z dowolną przyszłą datą ważności i dowolnym CVC. Na środowisku testowym nie pobierane są prawdziwe opłaty. Zanotuj kod rezerwacji na stronie potwierdzenia; zaczyna się od WNK.
Krok 8: Otrzymuj powiadomienia o rezerwacjach
Dział zatytułowany „Krok 8: Otrzymuj powiadomienia o rezerwacjach”-
W Portalu przejdź do
Applications > Webhooksi dodaj endpoint, który akceptuje żądaniaPOST. -
Subskrybuj
booking.create, lub pozostaw listę zdarzeń pustą, aby otrzymywać wszystko podczas rozwoju. -
Wyślij sobie testowe zdarzenie, potem zrób kolejną testową rezerwację i obserwuj jej przyjście.
Zawsze weryfikuj podpis każdej dostawy przed zaufaniem. Zobacz Integracja webhooków oraz Katalog zdarzeń webhook.
Krok 9: Przejdź do produkcji
Dział zatytułowany „Krok 9: Przejdź do produkcji”Nie ma kroku zatwierdzania dla deweloperów. (Konta agencji turystycznych są najpierw certyfikowane; zobacz poniżej.) Gdy Twoja integracja działa na środowisku testowym:
-
Utwórz konto i aplikację na app.wink.travel, jak w Krokach 1 i 2. Dane uwierzytelniające nie przenoszą się między środowiskami.
-
Usuń
staging-z każdego hosta:Środowisko testowe Produkcja https://staging-iam.wink.travelhttps://iam.wink.travelstaging-partner.wink.travel:443partner.wink.travel:443https://staging-book.wink.travelhttps://book.wink.travel -
Ponownie sprawdź ID konta produkcyjnego (Krok 4) i ID personalizacji (Krok 6). Różnią się od testowych.
Partner API jest rozliczane w hotelowych noclegach, z darmowym miesięcznym limitem. Zobacz Partner API dla cen i limitów.
Rezerwacje jako agencja turystyczna
Dział zatytułowany „Rezerwacje jako agencja turystyczna”Jeśli Twoje konto to licencjonowana agencja turystyczna, nie musisz kierować podróżnych do book.wink.travel: możesz tworzyć rezerwacje bezpośrednio przez wink.partner.v1.Booking/CreateBooking i zarządzać nimi innymi wywołaniami Booking. Inne konta kierują podróżnych do linku rezerwacji.
Konta agencji turystycznych są certyfikowane: Wink weryfikuje rejestrację każdej agencji przed umożliwieniem rezerwacji. Agencje, które chcą same pobierać płatności od klientów jako merchant of record, muszą rezerwować przez Partner API i uzyskać pisemną zgodę Wink. Zobacz Pierwsze kroki jako agencja turystyczna oraz dokumentację Partner API.
Kolejne kroki
Dział zatytułowany „Kolejne kroki”- Wygeneruj klienta typowanego z schematu
.protozamiast wywoływaćgrpcurlręcznie. - Podłącz serwer MCP i użyj AI Skills, aby Twój asystent programistyczny napisał integrację z użyciem API na żywo.
- Przeczytaj pełną listę środowisk i hostów.
