Darmowe API rezerwacji hoteli: co naprawdę daje darmowe

Jest czwartkowe popołudnie, a demo jest w poniedziałek. Znalazłeś darmowe API rezerwacji hoteli, zarejestrowałeś się adresem e-mail i po pięciu minutach miałeś klucz. Endpoint wyszukiwania zwraca hotele ze zdjęciami, gwiazdkami i ceną za noc. Wieczorem strona wyników wygląda dokładnie tak, jak powinna. W piątek podpinasz wywołanie rezerwacji, a ono odpowiada błędem, którego nie da się odczytać, bo to, na co się zapisałeś, nigdy nie potrafiło zrobić rezerwacji.
Nikt cię nie okłamał. "Darmowe" jest na tym rynku po prostu przyklejone do czterech różnych produktów, a strony rejestracji nie mówią, który trzymasz w ręku.
Cztery rzeczy, którymi może być "darmowe"
Tę tabelę warto trzymać obok klawiatury. Jeśli twój dostawca robi coś inaczej w którymś wierszu, nie zgódź się z nim; to też przydatne odkrycie.
| Czym jest darmowa oferta | Co dostajesz | Co możesz zbudować | Czego nie potrafi |
|---|---|---|---|
| Treści statyczne lub dane katalogowe | Nazwy hoteli, adresy, zdjęcia, udogodnienia, opisy | Przewodnik po hotelach, mapę, stronę kierunku | Pokazać cenę, którą możesz dotrzymać, ani pokój naprawdę wolny w twoich datach |
| Wyszukiwanie afiliacyjne z przekierowaniem | Hotele i ceny oraz link do własnego checkoutu sprzedawcy | Stronę porównania, która wysyła ruch dalej | Zatrzymać po twojej stronie klienta, płatność ani zapis rezerwacji |
| Sandbox z testowymi taryfami | Pełne wywołania wyszukiwania, ceny, rezerwacji i anulowania, odpowiadające zmyśloną dostępnością | Działającą integrację i demo, które zachowuje się jak produkcja | Utworzyć rezerwację, którą uzna prawdziwy hotel |
| Taryfy na żywo do rezerwacji | Prawdziwe pokoje po prawdziwych cenach net lub sprzedaży, potwierdzone przez dostawcę | Sklep, który przyjmuje pieniądze za pokoje | Być darmowym dla tego, kto podpisuje umowę |
Pierwsze trzy są darmowe, bo rozdawanie ich prawie nic dostawcy nie kosztuje. Czwarte nie jest, bo ktoś dźwiga coś prawdziwego.
Dlaczego taryfa do rezerwacji zawsze przychodzi z umową
Gdy twój klient płaci za pokój, rusza łańcuch zobowiązań. Dostawca ma umowę z hotelem. Ten dostawca obiecał hotelowi, że pokój zostanie opłacony, a tobie, że pokój istnieje. Jeśli gość anuluje po terminie darmowej anulacji, ktoś jest winien hotelowi noc. Jeśli taryfa była błędna, ktoś pokrywa różnicę. Jeśli karta była kradziona, ktoś zostaje z chargebackiem.
Wszystko to musi spaść na konkretną, nazwaną stronę. Klucz API, który każdy wygeneruje adresem e-mail, tego nie udźwignie, dlatego dostęp do rezerwacji przychodzi z umową, zasadami rozliczeń i często limitem kredytowym. Cena, którą płacisz za "darmowy" klucz, polega na tym, że dostawcy nie musi obchodzić, co z nim robisz.
To nie jest krytyka darmowych planów. Feed treści jest dokładnie tym, czego potrzeba do przewodnika po kierunku. Jest zły tylko wtedy, gdy ktoś bierze go za to, czego trzeba, by przyjąć rezerwację.
Jeśli decydujesz też, ilu dostawców potrzebujesz za tym, którego wybierzesz, omówiliśmy to w tekście ilu dostawców API hotelowych potrzebujesz; lotnicza wersja tego samego zamieszania jest w tekście trzy rodzaje darmowego API lotów.
W pierwszym wierszu kryje się jeszcze jedna pułapka. Treści statyczne i taryfy na żywo to dwa feedy o różnej żywotności: opis hotelu może leżeć w twoim cache tygodniami, taryfa na dzisiejszą noc nie może tam leżeć nawet minut. Darmowy feed treści, który pokazuje też cenę, podaje liczbę, za którą nie odpowiada, a strona na nim zbudowana radośnie pokaże pokój sprzedany wczoraj.
Co przetestować w sandboxie, zanim podpiszesz jakąkolwiek umowę
Sandbox to najbardziej przydatna darmowa rzecz w tabeli, więc wyciśnij go do końca. Dobry sandbox pozwala przejść każdy krok prawdziwej rezerwacji, z dostępnością fałszywą, ale w kształcie prawdziwej.
- Szukaj z dziećmi i kilkoma pokojami. Obłożenie to miejsce, gdzie proste integracje psują się najpierw. Poproś o dwa pokoje z różnymi gośćmi i sprawdź, czy odpowiedź trzyma je osobno.
- Sprawdź cenę przed rezerwacją. Wielu dostawców oczekuje drugiego wywołania, które potwierdza, że taryfa nadal obowiązuje. Jeśli sandbox nie ma tego kroku, zapytaj, czy ma go produkcja.
- Zarezerwuj, a potem przeczytaj, co wróciło. Potwierdzony pokój, oczekujące zgłoszenie i pokój na zapytanie to trzy różne wyniki, a twój ekran musi powiedzieć, który.
- Zmień taryfę między wyszukiwaniem a rezerwacją. Taryfy się zmieniają. Jak wygląda błąd i czy twój kod potrafi pokazać klientowi nową cenę zamiast pustej strony?
- Anuluj w darmowym oknie i poza nim. Zasady anulacji powinny przychodzić jako dane strukturalne z datami i kwotami, a nie akapit, który trzeba parsować.
- Zawiedź celowo. Wyślij złą datę, nieznany kod hotelu, wygasły token. Policz, ile różnych kształtów błędu dostajesz.
Jeśli sandbox nie potrafi kroków czwartego i piątego, masz API treści z URL-em, który tylko udaje rezerwację.
Ile kosztuje budowanie na złym rodzaju
Droga wersja tego błędu to nie stracony tydzień. To demo, które się udaje.
Pokazujesz decydentowi schludną stronę wyszukiwania, on zatwierdza budżet, i dopiero wtedy zespół odkrywa, że źródło za nią nie potrafi potwierdzić pokoju. Kod nie idzie w całości do kosza, ale proces rezerwacji, krok płatności, obsługę anulacji i rozliczenia trzeba zbudować pod innego dostawcę z innymi nazwami pól. Strona wyszukiwania, którą pokazałeś, zwróci wtedy inne hotele, po innych cenach, w innej kolejności. Ten, kto zatwierdził budżet, to zauważy.
Tańszy nawyk to zadać jedno pytanie, zanim napiszesz jakikolwiek kod: "Czy ten klucz może utworzyć rezerwację, którą hotel uzna, a potem ją anulować?" Jeśli odpowiedź jest inna niż tak, wiesz, którą z czterech trzymasz.
Gdzie stoi ta platforma
Powinniśmy mówić o własnej pozycji równie otwarcie jak o innych. Platforma udostępnia API lotów i hoteli, a dostęp zaczyna się od rozmowy, nie od klucza samoobsługowego. To czwarty wiersz tabeli: za dostępnością do rezerwacji stoi ktoś, kto musi wiedzieć, kto pyta. Jeśli chcesz zobaczyć, jak to działa dla twojego projektu, zacznij od strony z API podróżnymi i powiedz nam, co budujesz.
Darmowe treści, linki afiliacyjne i sandboxy mają swoje miejsce, a właściwy wybór zależy od tego, co zamierzasz sprzedawać. Wybieraj według tego, co klucz potrafi w dniu, w którym klient płaci.