Integracja API hotelowego

Integracja API RateHawk: od klucza API do rzeczywistych rezerwacji hoteli

Połącz swoje konto RateHawk z PHPTRAVELS i sprzedawaj hotele oraz apartamenty RateHawk na własnej stronie i w portalu dla agentów. Konektor jest gotowy: dodaj klucze API, zaimportuj bazę hoteli, ustaw marżę i przejdź certyfikację RateHawk.

  • Gotowy konektor RateHawk
  • ETG API v3
  • Import zrzutu hoteli
  • Twoja marża na stawkach netto

Dostawca

Czym jest RateHawk i dlaczego agencje go podłączają

RateHawk to platforma rezerwacyjna B2B firmy Emerging Travel Group (ETG) dla agentów turystycznych, touroperatorów i firm turystycznych. Partnerzy rezerwują hotele, apartamenty i inne obiekty noclegowe po stawkach netto — we własnym portalu RateHawk lub przez jego API.

To API nazywa się ETG API. Jego aktualna wersja to v3 — REST API z zapytaniami i odpowiedziami w formacie JSON, obejmujące wyszukiwanie, rezerwację i anulację. PHPTRAVELS ma gotowy konektor RateHawk w module noclegów, więc wyniki RateHawk pojawiają się obok Twoich innych dostawców hoteli i własnych kontraktów.

Powiązane:NoclegiSilnik rezerwacji hotelowychAPI turystyczne

Karta dostawcy
Firma
RateHawk, część Emerging Travel Group
Rodzaj
Platforma noclegowa B2B dla profesjonalistów branży turystycznej
Oferta
Ponad 2,6 mln obiektów noclegowych, według RateHawk
Partnerzy API
Ponad 700 klientów API, według danych RateHawk z 2024 roku
API
ETG API v3 · REST · JSON
W PHPTRAVELS
Gotowy konektor w module noclegów

Proces rezerwacji w ETG API v3

Jak przebiega rezerwacja RateHawk, etap po etapie

Każda rezerwacja RateHawk przechodzi przez tych samych pięć etapów. Przy każdym podajemy wywołania ETG API oraz to, co PHPTRAVELS robi za Ciebie.

  1. 01

    Wyszukiwanie

    Wywołania ETG API

    Wyszukiwanie według regionu · współrzędnych geograficznych · ID hoteli

    PHPTRAVELS

    Wyszukuje według miasta, obszaru na mapie lub listy hoteli, z datami, liczbą gości i krajem zamieszkania podróżnego, i pokazuje aktualne stawki netto z Twoją marżą.

  2. 02

    Strona hotelu

    Wywołania ETG API

    Retrieve hotelpage

    PHPTRAVELS

    Pobiera wszystkie pokoje i stawki wybranego hotelu: wyżywienie, podatki, warunki anulacji i formę płatności.

  3. 03

    Wstępna rezerwacja

    Wywołania ETG API

    Prebook rate · Retrieve rate info

    PHPTRAVELS

    Tuż przed płatnością sprawdza, czy wybrana stawka jest nadal dostępna w tej cenie, i zatrzymuje proces zakupu, jeśli cena się zmieniła.

  4. 04

    Rezerwacja

    Wywołania ETG API

    Utworzenie, uruchomienie i sprawdzenie procesu rezerwacji

    PHPTRAVELS

    Tworzy rezerwację, przesyła dane gości, śledzi status aż do potwierdzenia i zapisuje ID zamówienia RateHawk.

  5. 05

    Po rezerwacji

    Wywołania ETG API

    Retrieve bookings · Cancel booking · Webhooki statusów

    PHPTRAVELS

    Wysyła voucher, pokazuje rezerwację w panelu administracyjnym i na koncie klienta oraz obsługuje anulacje zgodnie z warunkami stawki.

Dane statyczne

Zaimportuj bazę hoteli RateHawk raz, a potem utrzymuj ją na bieżąco

Wyniki wyszukiwania zawierają tylko stawki. Nazwy, adresy, zdjęcia, udogodnienia i opisy pochodzą z danych statycznych ETG, które PHPTRAVELS importuje na Twoje strony hoteli.

  • Zrzut regionów

    Kraje, miasta i obszary, aby podróżni mogli wyszukiwać według kierunku.

  • Zrzut hoteli

    Pełny plik treści hotelowych: nazwy, adresy, współrzędne, zdjęcia, udogodnienia i opisy.

  • Zrzut przyrostowy

    Tylko zmiany od ostatniego importu, dzięki czemu katalog jest aktualny bez pełnego przeładowania.

  • Zrzut opinii

    Oceny i treści opinii gości do wyświetlania na stronach hoteli, jeśli obejmuje je Twoja umowa.

Import treści hotelowych
  • Zrzut regionów100%
  • Zrzut hoteli100%
  • Zrzut przyrostowy64%
  • Zrzut opinii30%

Przykładowy ekran. Liczby zależą od Twojego konta i języków.

Oprócz plików zrzutów ETG oferuje też Content API do pobierania danych hoteli na żądanie.

Klucz API i sandbox

Jak działa uwierzytelnianie w API RateHawk

ETG API korzysta z uwierzytelniania HTTP Basic. Twój key ID to nazwa użytkownika, a klucz API to hasło; są wysyłane przez HTTPS z każdym zapytaniem.

Zapytanie wyszukiwania w sandboxie (przykład)
 1# HTTP Basic: key ID = username, API key = password 2curl -u "$KEY_ID:$API_KEY" \ 3  -H "Content-Type: application/json" \ 4  https://api-sandbox.ratehawk.com/api/b2b/v3/search/serp/hotels/ \ 5  -d '{ 6    "checkin": "2026-11-14", 7    "checkout": "2026-11-16", 8    "residency": "gb", 9    "language": "en",10    "currency": "USD",11    "guests": [{ "adults": 2, "children": [] }],12    "hids": [8473727]13  }'1415# 8473727 = the test hotel: a real booking if you book it
HTTP BasicETG API v3api-sandbox.ratehawk.com → api.ratehawk.com
Dwa hosty
Sandbox: api-sandbox.ratehawk.com. Testy i produkcja: api.ratehawk.com. Stare hosty worldota.net są wycofywane.
Hotel testowy jest prawdziwy
Kluczami testowymi można rezerwować wyłącznie hotel testowy o hid 8473727, a taka rezerwacja jest prawdziwa i wiąże się z realną odpowiedzialnością finansową. Anuluj ją zaraz po teście.
Klucze zostają na serwerze
PHPTRAVELS przechowuje key ID i klucz API w konfiguracji serwera, nigdy w przeglądarce ani w aplikacji.
Kraj zamieszkania ma znaczenie
Stawki zależą od kraju zamieszkania podróżnego, dlatego konektor przesyła go przy każdym wyszukiwaniu.

Konfiguracja w PHPTRAVELS

Skonfiguruj konektor RateHawk w czterech krokach

Bez pisania kodu: konektor konfiguruje się w panelu administracyjnym.

  1. 01Dodaj klucze APIWklej key ID i klucz API od RateHawk — najpierw dla sandboxa, później dla produkcji.
  2. 02Zaimportuj bazę hoteliWczytaj zrzuty regionów i hoteli, a następnie zaplanuj aktualizacje przyrostowe.
  3. 03Ustaw marżę i walutęMarże procentowe lub stałe, według kanału, grupy agentów lub kierunku, w walutach, w których sprzedajesz.
  4. 04Przetestuj i uruchomWykonaj testową rezerwację i anulację, przejdź certyfikację, a potem przełącz na klucze produkcyjne.
Dostawcy › RateHawkRateHawk

Środowisko

https://api-sandbox.ratehawk.comhttps://api.ratehawk.com

Key ID4127
Klucz API••••••••••••••••
Marża12% na stawkach netto
WalutaUSD · EUR · GBP
Domyślny kraj zamieszkaniaGB

Przykładowy ekran ustawień.

Certyfikacja

Od umowy do dostępu produkcyjnego

RateHawk udostępnia środowisko produkcyjne dopiero po podpisaniu umowy i pozytywnym przejściu certyfikacji przez Twoją integrację.

  1. 1

    Podpisz umowę API

    Ty

    Skontaktuj się z RateHawk jako firma turystyczna i podpisz umowę API dla swoich rynków.

  2. 2

    Otrzymaj klucze sandbox

    RateHawk

    RateHawk wydaje key ID i klucz API dla sandboxa.

  3. 3

    Połączenie i import

    PHPTRAVELS

    Klucze trafiają do PHPTRAVELS, dane statyczne są importowane, a marże ustawiane.

  4. 4

    Przejdź certyfikację

    RateHawk

    RateHawk sprawdza integrację, w tym proces rezerwacji, statusu i anulacji.

  5. 5

    Dostęp produkcyjny

    Ty

    Klucze produkcyjne trafiają do panelu i zaczynają się rzeczywiste rezerwacje.

Portal, API czy silnik rezerwacji

Trzy sposoby sprzedaży hoteli RateHawk

Agenci mogą już dziś rezerwować na stronie RateHawk. To API w Twoim własnym silniku rezerwacji pozwala sprzedawać hotele RateHawk pod Twoją marką.

  • Strona RateHawk

    Kto rezerwuje
    Twoi agenci, rezerwacja po rezerwacji
    Czyja marka
    RateHawk
    Czego wymaga
    Rejestracja jako agent i logowanie
  • Własna integracja API

    Kto rezerwuje
    Twoi klienci i agenci, online
    Czyja marka
    Twoja
    Czego wymaga
    Miesiące programowania i certyfikacji
  • PHPTRAVELS z RateHawk

    Kto rezerwuje
    Twoi klienci i agenci, online
    Czyja marka
    Twoja
    Czego wymaga
    Konfiguracja, import treści i certyfikacja

Wielu dostawców

RateHawk obok Twoich innych dostawców hoteli

RateHawk to jeden z dostawców w module noclegów. To samo wyszukiwanie może obejmować Twoje inne API hotelowe i własne kontrakty, z marżami i routingiem ustawianymi dla każdego dostawcy.

  • Agoda
  • Amadeus
  • Booking.com
  • Hotelbeds
  • Hotelston
  • RateHawk
  • Stuba
  • TBO Holidays
  • Travelport
  • Wanderbeds

Przeczytaj przewodnik dla agentów

FAQ

Pytania o integrację API RateHawk

O co pytają agencje przed podłączeniem RateHawk.

Kontakt ze sprzedażą

RateHawk nie publikuje opłaty za dostęp do API. Podpisujesz umowę API i sprzedajesz jego hotele po stawkach netto z własną marżą. Twoje koszty to oprogramowanie rezerwacyjne, hosting i płatności.

Skontaktuj się z RateHawk jako firma turystyczna i podpisz umowę API. RateHawk wydaje wtedy key ID i klucz API dla sandboxa, a po certyfikacji klucze produkcyjne.

Dokumentacja ETG API jest dostępna online pod adresem docs.emergingtravel.com i obejmuje B2B API, Content API, sandbox oraz przewodniki certyfikacji. Nie ma osobnego pliku PDF do pobrania; aktualną wersją jest dokumentacja online.

ETG API to API firmy Emerging Travel Group, do której należy RateHawk. Integracja API RateHawk i integracja ETG API oznaczają to samo; aktualna wersja to v3.

PHPTRAVELS to jednorazowa licencja od 2499 USD z pełnym kodem źródłowym, a konektor RateHawk jest zawarty w module noclegów. Warunki handlowe RateHawk uzgadniasz bezpośrednio z RateHawk.

Tak, pod adresem api-sandbox.ratehawk.com. Pamiętaj, że kluczami testowymi można rezerwować wyłącznie hotel testowy o hid 8473727, a taka rezerwacja jest prawdziwa, więc anuluj ją zaraz po testach.

Agenci rejestrują się i logują na ratehawk.com, aby rezerwować w portalu. Dostęp do API jest oddzielny: korzysta z key ID i klucza API z Twojej umowy, a nie z loginu do portalu.

Konektor już istnieje, więc czas pochłania umowa, dodanie kluczy, import treści hotelowych i certyfikacja RateHawk, a nie programowanie.

Tak. Ten sam konektor obsługuje Twoją stronę B2C i portal B2B dla agentów, z osobnymi marżami dla każdego kanału i grupy agentów.

Każda stawka ma własne warunki anulacji, pokazywane przed płatnością. Anulacje wykonuje się z panelu administracyjnego lub konta klienta przez wywołanie anulowania rezerwacji, zgodnie z tymi warunkami.