Platforma dla programistów ChatBeds
Twórz integracje, które odczytują i zapisują pokoje, ceny, rezerwacje i rachunki hotelu w ChatBeds, systemie PMS obsługiwanym przez WhatsApp i panel w przeglądarce.
ChatBeds prowadzi recepcję, rezerwacje, housekeeping i rozliczenia hotelu przez WhatsApp i panel w przeglądarce. Platforma dla programistów pozwala Twojemu oprogramowaniu pracować z tymi danymi przez jedno API REST, Partner API (/partner/v1), i dowiadywać się o zmianach przez podpisane webhooki.
Co możesz zbudować
- Strony i kanały rezerwacji. Sprawdzaj dostępność i ceny na żywo, a potem twórz, zmieniaj i anuluj rezerwacje.
- Channel managery i konektory PMS. Odczytuj typy pokoi, plany cenowe i pokoje oraz utrzymuj aktualną kopię każdej rezerwacji, niezależnie od tego, kto ją utworzył.
- Narzędzia do komunikacji z gośćmi. Wyszukuj pobyty po dacie, nazwisku gościa lub własnym numerze referencyjnym i reaguj, gdy rezerwacja się zmienia.
- Narzędzia do płatności i księgowości. Odczytuj rachunek gościa, dodawaj opłaty, zapisuj płatności i twórz linki do płatności kartą na własnym koncie Stripe hotelu.
Dwa sposoby dostępu
| Aplikacja (zalecane) | Klucz prywatny | |
|---|---|---|
| Dla kogo | Oprogramowanie oferowane wielu hotelom | Jeden hotel, który pracuje z Tobą bezpośrednio |
| Jak hotel się łączy | Klika Connect w katalogu aplikacji, a potem Allow (OAuth 2.0) | Właściciel tworzy klucz w Settings → Partner API i przesyła go Tobie |
| Dane uwierzytelniające | Token dostępu cbat_... (1 godzina) i token odświeżania | Klucz API cbk_... (nie wygasa, dopóki nie zostanie unieważniony) |
| Uprawnienia | Tylko zakresy (scopes), na które hotel pozwolił | Wszystko w tym obiekcie |
Oba sposoby wywołują te same 25 operacje pod tym samym adresem bazowym, z tą samą idempotencją, limitami i webhookami. Każde dane uwierzytelniające działają dla jednego obiektu.
Jak to wszystko się łączy
- Zakładasz bezpłatne konto deweloperskie i dostajesz Sandbox Hotel z danymi testowymi oraz klucz API.
- Tworzysz integrację na hotelu testowym z tym kluczem.
- Rejestrujesz aplikację na stronie Developers i dostajesz client ID oraz secret.
- Łączysz aplikację z własnym hotelem testowym przez OAuth, aby przetestować cały proces.
- Wysyłasz aplikację do weryfikacji. Gdy ChatBeds ją zatwierdzi, pojawia się w katalogu aplikacji każdego hotelu.
- Hotel łączy Twoją aplikację, Twój serwer wymienia kod na tokeny i wywołuje
/partner/v1dla tego obiektu. - ChatBeds wysyła na Twój adres webhooka podpisane zdarzenie za każdym razem, gdy rezerwacja w tym obiekcie zostaje utworzona, zmieniona lub anulowana.
Tworzenie jest bezpłatne
Konta deweloperskie i Sandbox Hotel są bezpłatne i nigdy nie są rozliczane. Możesz łączyć własne aplikacje z własnym hotelem testowym na każdym etapie, także przed weryfikacją.
Co dalej
Szybki start
Pierwsze wywołanie i pierwsza rezerwacja w kilka minut.
Aplikacje i OAuth
Zarejestruj aplikację i pozwól każdemu hotelowi ją połączyć.
Dokumentacja API
Wszystkie 25 operacje, z prawdziwymi żądaniami i odpowiedziami.
Webhooki
Odbieraj zdarzenia rezerwacji i weryfikuj ich podpisy.
Poradniki
Kompletne przewodniki po typowych integracjach.
Zasoby
Błędy, idempotencja, limity, lista zmian i wsparcie.
Tworzysz coś?