Przejdź do głównej zawartości

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.

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 turystycznaTen przewodnik do Kroku 5, potem Rezerwacje jako agencja turystyczna
Osadzić rezerwowane hotele bez pisania integracjiWeb Components
Pozwolić agentowi AI wyszukiwać i rezerwowaćMCP Servers oraz Agentic Payments
Podłączyć channel managera lub PMSDodaj swojego channel managera

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.

Będziesz potrzebować:

  • grpcurl, lub Postman albo Insomnia. Partner API to gRPC, nie REST.
  • curl.

Środowisko testowe jest całkowicie oddzielone od produkcji, z własnymi loginami i kontami.

  1. Przejdź do staging-app.wink.travel, kliknij Sign-In / Register i zarejestruj się.

  2. Kliknij Accounts w lewym pasku bocznym, potem Create i wybierz I am an Affiliate. Rezerwacje, które wyślesz, będą przypisane do tego konta. Zobacz Utwórz konto.

Aplikacja nada Twojemu kodowi dane uwierzytelniające.

  1. Na karcie konta kliknij Actions > Manage account, a następnie zakładkę Applications.

  2. Kliknij Create new application, nadaj jej nazwę i wybierz Machine-to-machine jako typ klienta.

  3. W sekcji scopes wybierz Inventory & rates (odczyt). Partner API wymaga inventory.read.

  4. Kliknij Create application i 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.

Okno terminala
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:

Okno terminala
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:

errorStatus HTTPTypowa przyczyna
invalid_client401Błędny client ID lub secret, albo użycie danych produkcyjnych na staging-iam
invalid_scope400Żądanie zawiera zakres, którego aplikacja nie ma
unauthorized_client400Aplikacja nie ma prawa używać grant client_credentials
invalid_request400Brak wymaganego parametru, np. gdy ciało jest JSON zamiast formularza

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:

Okno terminala
grpcurl -H "authorization: Bearer $WINK_TOKEN" \
-d '{}' \
staging-partner.wink.travel:443 wink.partner.v1.Accounts/ListAccounts

Skopiuj accountId konta afilianta z Kroku 1:

Okno terminala
export WINK_ACCOUNT_ID=<accountId>

Środowisko testowe ma testowe hotele z dostępnością w Bangkoku, więc to wyszukiwanie używa jego slug bangkok-thailand:

Okno terminala
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/SearchByCity

Użyj daty zameldowania w przyszłości; data z przeszłości zostanie odrzucona. Każdy wynik zawiera:

  • name, starRating i heroImageUrl, 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.

https://staging-book.wink.travel/hotel/<urlName>?client-id=<YOUR_CLIENT_ID>&configuration-id=<YOUR_CUSTOMIZATION_ID>
  • <urlName> to urlName hotelu z Kroku 5.
  • client-id to Client ID Twojej aplikacji z Kroku 2.
  • configuration-id to Twój ID personalizacji: Manage account > Customizations. Personalizacja ustawia też branding, domyślny język i walutę na stronie rezerwacji.

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
ParametrZnaczeniePrzykład
sdData zameldowaniasd=2027-03-14
n lub edLiczba nocy lub data wymeldowanian=2 lub ed=2027-03-16
rcGoście na pokójrc=a2 (2 dorosłych)
lJęzyk wyświetlanial=en
cWaluta wyświetlaniac=USD
pKod promocyjnyp=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.

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.

  1. W Portalu przejdź do Applications > Webhooks i dodaj endpoint, który akceptuje żądania POST.

  2. Subskrybuj booking.create, lub pozostaw listę zdarzeń pustą, aby otrzymywać wszystko podczas rozwoju.

  3. 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.

Nie ma kroku zatwierdzania dla deweloperów. (Konta agencji turystycznych są najpierw certyfikowane; zobacz poniżej.) Gdy Twoja integracja działa na środowisku testowym:

  1. Utwórz konto i aplikację na app.wink.travel, jak w Krokach 1 i 2. Dane uwierzytelniające nie przenoszą się między środowiskami.

  2. Usuń staging- z każdego hosta:

    Środowisko testoweProdukcja
    https://staging-iam.wink.travelhttps://iam.wink.travel
    staging-partner.wink.travel:443partner.wink.travel:443
    https://staging-book.wink.travelhttps://book.wink.travel
  3. 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.

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.