Demo na żywo

Integracja dostawców hotelowych

Integracja API Hotelbeds: treści, mapowanie i rezerwacje na żywo

Integracja API Hotelbeds to dwa zadania, a nie jedno. Pobierają Państwo i zapisują treści hotelowe, a następnie rezerwują według stawek na żywo. PHPTRAVELS realizuje oba zadania w module hoteli, z Państwa własną umową i kluczami Hotelbeds.

  • Synchronizacja Content API
  • Przepływ Booking API
  • Stawki BOOKABLE i RECHECK
  • Mapowanie hoteli

Jak współpracują API Hotelbeds

Integracja API Hotelbeds: treści po jednej stronie, rezerwacje po drugiej

Hotelbeds dzieli swoje API hotelowe na dwie części. Content API zwraca dane statyczne: opisy, zdjęcia, udogodnienia, rodzaje wyżywienia i pokoje. Booking API zwraca dostępność i ceny na żywo oraz przyjmuje rezerwację. Proszę wybrać krok pośrodku, aby zobaczyć, jakich wywołań używa.

Content API

Statyczne, przechowywane u Państwa
  • Lista hotelihotels · from=1&to=1000Wszystkie hotele z Państwa portfolio, w stronach do 1000 hoteli na zapytanie.
  • Udogodnienia, wyżywienie i pokojefacilities · boards · roomsTabele kodów, które zamieniają kody z Booking API na słowa zrozumiałe dla gości.
  • Zdjęciaphotos.hotelbeds.com/giata/Częściowe ścieżki zdjęć, łączone z serwerem zdjęć Hotelbeds w potrzebnym rozmiarze.
  • Codzienne zmianylastUpdateTimePo pierwszym pobraniu jedno zapytanie dziennie z lastUpdateTime zwraca tylko to, co się zmieniło.

Przepływ zapytań

Booking API

Na żywo, wywoływane dla każdego gościa
  • DostępnośćPOST /hotelsPokoje, wyżywienie, ceny i opłaty za anulację dla Państwa kodów hoteli, dat i obłożenia.
  • Weryfikacja stawkiPOST /checkratesAktualna cena i warunki dla stawki oznaczonej RECHECK, wraz z opcjami upsellingu.
  • RezerwacjaPOST /bookingsPotwierdza wybrany rateKey z danymi osoby rezerwującej i gości oraz zwraca numer referencyjny.
  • AnulacjaDELETE /bookings · simulateSymuluje anulację, aby pokazać opłatę, albo faktycznie anuluje rezerwację.
Przykładowy ekran. Wywołania zgodne z dokumentacją developer.hotelbeds.com; przepływ pokazuje, jak używa ich PHPTRAVELS.

Większość nieudanych projektów z Hotelbeds miesza obie strony. Wywołują Content API podczas wyszukiwania gościa, co jest wolne i, jak ostrzega Hotelbeds, może skończyć się zablokowaniem danych dostępowych. Albo wyszukują na żywo bez zapisanych kodów i nie mogą pokazać zdjęć ani udogodnień. PHPTRAVELS rozdziela obie strony: treści są synchronizowane w tle, a podczas oczekiwania gościa działają tylko wywołania dostępności, weryfikacji stawki i rezerwacji.

Jeśli interesuje Państwa sam dostawca, jego produkty i sposób założenia konta, zapraszamy do lektury: profil dostawcy Hotelbeds. Ta strona dotyczy integracji technicznej.

Rodzaje stawek

Cztery pola stawki, które zmieniają proces płatności

Każda stawka Hotelbeds ma kilka atrybutów, które decydują, czy można ją od razu zarezerwować, jaką cenę wolno pokazać i kto pobiera pieniądze. To właśnie je silnik musi odczytać w każdym wyniku.

PolePierwszy przypadekDrugi przypadekCo robi PHPTRAVELS

Do rezerwacji lub do weryfikacji

rateType		BOOKABLE

Stawka jest aktualna. Można ją zarezerwować bez kolejnego wywołania.

RECHECK

Najpierw trzeba wywołać weryfikację stawki, aby uzyskać aktualną cenę i warunki.

Dla stawek RECHECK uruchamia weryfikację stawki przed płatnością i pokazuje gościowi każdą zmianę.

Netto lub prowizyjna

net · sellingRate		net

Model netto: ceny są netto, więc dodają Państwo własną marżę.

sellingRate

Model prowizyjny: prowizja jest już wliczona w sellingRate, a ta cena jest ostateczna.

Stosuje Państwa reguły marży do stawek netto i sprzedaje stawki prowizyjne po sellingRate.

Stała cena sprzedaży

hotelMandatory		true

hotelMandatory ma wartość true: należy sprzedawać po sellingRate.

false · null

False lub puste przy stawce netto: można ustalić własną marżę.

Blokuje wyświetlaną cenę na poziomie sellingRate, gdy hotel tego wymaga, niezależnie od reguły marży.

Kiedy płaci gość

paymentType		AT_WEB

Płatność jest pobierana przy rezerwacji, przez Państwa stronę.

AT_HOTEL

Gość płaci bezpośrednio w hotelu.

Oznacza stawkę jako płatność teraz lub płatność w hotelu i dopasowuje proces płatności.

Model cenowy zależy od Państwa umowy z Hotelbeds. Jak podaje Hotelbeds, Państwa opiekun handlowy rekomenduje model odpowiedni dla firmy.

Mapowanie hoteli

Dopasowanie hoteli Hotelbeds do hoteli, które już Państwo sprzedają

Jeśli mają Państwo własne umowy lub drugiego dostawcę, ten sam hotel pojawi się pod różnymi kodami. Mapowanie je łączy, dzięki czemu gość widzi jeden hotel z najlepszą stawką, a nie trzy kopie.

Jak działa mapowanie w PHPTRAVELS

Po każdej synchronizacji treści PHPTRAVELS porównuje hotele Hotelbeds z Państwa listą hoteli według nazwy, adresu, miasta i współrzędnych. Pewne dopasowania są łączone automatycznie. Wątpliwe czekają na potwierdzenie przez osobę, a hotele bez dopasowania można zaimportować jako nowe obiekty lub pominąć.

Zmapowane hotele mają wspólną stronę, galerię i ocenę z opinii w module Noclegi, a każdy dostawca zachowuje własne stawki i reguły. To samo mapowanie wykorzystuje Państwa publiczna strona i Portal turystyczny B2B.

Mapowanie hoteli
  • Harbour View HotelLizbona48291397%Dopasowany
  • Old Town SuitesPraga11735492%Dopasowany
  • Palm Court ResortDubaj66201874%Sprawdź
  • Casa Azul BoutiqueSewilla–0%Brak dopasowania
  • Northern Lights LodgeTromsø90522766%Sprawdź
  • Riverside ApartmentsBudapeszt33076198%Dopasowany

Przykładowy ekran z fikcyjnymi hotelami i kodami.

Hotelbeds XML czy JSON

Każde zapytanie jest podpisane, a testy zaczynają się od małej skali

Zespoły wciąż szukają Hotelbeds XML, ale aktualna dokumentacja pokazuje zapytania JSON. Tak czy inaczej to ten sam zestaw operacji, a każde zapytanie zawiera dwa nagłówki.

availability-request.sh (przykład)
 1# X-Signature = SHA256(api key + secret + unix time in seconds) 2TS=$(date +%s) 3SIG=$(printf "%s%s%s" "$API_KEY" "$SECRET" "$TS" | sha256sum | cut -d" " -f1) 4 5curl -X POST https://api.test.hotelbeds.com/hotel-api/1.0/hotels \ 6  -H "Api-key: $API_KEY" \ 7  -H "X-Signature: $SIG" \ 8  -H "Accept: application/json" \ 9  -H "Content-Type: application/json" \10  -d '{11    "stay": { "checkIn": "2026-11-14", "checkOut": "2026-11-17" },12    "occupancies": [{ "rooms": 1, "adults": 2, "children": 0 }],13    "hotels": { "hotel": [482913, 117354] }14  }'1516# hotel codes come from your stored Content API data, never a live content call
Api-keyX-Signatureapi.test.hotelbeds.com
Dwa nagłówki
Api-key z Państwa kluczem oraz X-Signature: skrót SHA256 z klucza, sekretu i bieżącego czasu w sekundach.
Serwer testowy
Jak podaje Hotelbeds, serwery testowe odpowiadają produkcyjnym, ale rezerwacje nie są prawdziwe, a karty nie są obciążane.
50 zapytań dziennie
Nowe klucze otwierają środowisko ewaluacyjne z limitem 50 zapytań dziennie. Certyfikacja zwiększa limit.
Bez wywołań treści na żywo
Hotelbeds ostrzega, że wywoływanie Content API w czasie rzeczywistym może skończyć się zablokowaniem danych dostępowych. PHPTRAVELS nigdy tego nie robi.

Planer synchronizacji treści

Ile wywołań Content API potrzebuje Państwa lista hoteli

Jak podaje Hotelbeds, lista hoteli przychodzi w stronach do 1000 hoteli, a po pierwszym pobraniu codzienne zapytanie z lastUpdateTime zwraca tylko zmiany. Proszę wpisać swoje liczby, aby zaplanować synchronizację.

Zapytania przy pierwszym pełnym pobraniu
20
Zapytania na codzienną aktualizację
3
Dni na jedno pełne pobranie przy limicie ewaluacyjnym
1

Tylko szacunek dla listy hoteli. Tabele kodów i zdjęcia dodają kilka wywołań. Przy limicie ewaluacyjnym 50 zapytań dziennie warto najpierw testować na jednym kierunku.

Lista kontrolna przed startem

Co przygotować przed przejściem na produkcję

Hotelbeds prowadzi Państwa przez swój panel od ewaluacji przez certyfikację do kluczy produkcyjnych. Oto punkty, które integracja API Hotelbeds powinna objąć w pierwszej kolejności, i sposób, w jaki obejmuje je PHPTRAVELS.

  • Klucze ewaluacyjne dodane w panelu, wybrany serwer testowy
  • Content API zsynchronizowane z bazą danych, zaplanowana codzienna aktualizacja
  • Hotele zmapowane z listą, wątpliwe dopasowania sprawdzone
  • Stawki RECHECK przechodzą weryfikację stawki przed płatnością
  • sellingRate przestrzegany, gdy hotelMandatory ma wartość true
  • Uwagi do stawki i opłaty za anulację widoczne, zanim gość zapłaci
  • Voucher pokazuje numer referencyjny Hotelbeds i uwagi do stawki
  • Anulacja najpierw symulowana, potem potwierdzana, z zapisaną opłatą

Kroki certyfikacji i dostęp produkcyjny ustala Hotelbeds dla Państwa umowy i rynku.

Koszt

Jedna licencja na silnik, własna umowa z Hotelbeds

PHPTRAVELS to jednorazowa licencja z kodem źródłowym. Hotelbeds to osobna umowa między Państwem a Hotelbeds, więc stawki netto i klucze pozostają Państwa.

Startup
Licencja jednorazowa
licencja jednorazowa
Agency
Licencja jednorazowa
licencja jednorazowa
Enterprise
Licencja jednorazowa
licencja jednorazowa

Hotelbeds to jedno z kilku źródeł hoteli, z których można korzystać równolegle. Zobacz, jak współpracuje z RateHawk w przeglądzie API turystycznych, lub porównaj dostawców na stronie lista dostawców XML.

Zobacz cennikWypróbuj demo hoteli

FAQ

Pytania o integrację API Hotelbeds

O co pytają programiści i firmy turystyczne przed podłączeniem Hotelbeds.

Kontakt ze sprzedażą

Na dwóch częściach. Synchronizacji w tle z Content API, która zapisuje hotele, zdjęcia, udogodnienia, rodzaje wyżywienia i pokoje w bazie danych, oraz przepływie na żywo z Booking API dla dostępności, weryfikacji stawki, rezerwacji i anulacji. PHPTRAVELS obsługuje obie w module hoteli.

Wiele osób wciąż mówi Hotelbeds XML, ale aktualna dokumentacja Hotelbeds pokazuje zapytania i odpowiedzi JSON. Operacje są takie same w obu przypadkach, a PHPTRAVELS obsługuje format za Państwa.

Stawka BOOKABLE jest już aktualna i można ją od razu zarezerwować. Stawka RECHECK wymaga najpierw wywołania weryfikacji stawki, które zwraca aktualną cenę i warunki. PHPTRAVELS wykonuje to wywołanie przed krokiem płatności.

To jest wolne, a Hotelbeds ostrzega, że korzystanie z Content API w czasie rzeczywistym może skończyć się zablokowaniem danych dostępowych. Treści należy pobierać stronami, zapisywać i aktualizować raz dziennie z lastUpdateTime. Tak właśnie działa PHPTRAVELS.

Tak. Rejestrują się Państwo w Hotelbeds, podpisują umowę i otrzymują własny klucz API oraz sekret. Nowe klucze działają w środowisku ewaluacyjnym z limitem 50 zapytań dziennie do czasu ukończenia certyfikacji.

Tak. Mapowanie hoteli łączy ten sam obiekt z różnych źródeł, więc goście widzą jeden hotel z najlepszą dostępną stawką, a każde źródło zachowuje własną marżę i reguły.

Plany PHPTRAVELS zaczynają się od jako licencja jednorazowa z kodem źródłowym. Umowa z Hotelbeds jest osobna i zawierana bezpośrednio z Hotelbeds. Zapraszamy na stronę cennika lub do kontaktu z działem sprzedaży po wycenę.

Odkryj więcej

Więcej o platformie