Платформа для разработчиков ChatBeds
Создавайте интеграции, которые читают и записывают номера, цены, бронирования и счета отеля в ChatBeds — PMS для отелей, которой управляют через WhatsApp и веб-панель.
ChatBeds ведёт ресепшн, бронирования, хаускипинг и расчёты отеля через WhatsApp и веб-панель. Платформа для разработчиков позволяет вашему ПО работать с этими данными через один REST API — Partner API (/partner/v1) — и узнавать об изменениях через подписанные вебхуки.
Что можно создать
- Сайты и каналы бронирования. Проверяйте актуальную доступность и цены, затем создавайте, изменяйте и отменяйте бронирования.
- Менеджеры каналов и коннекторы PMS. Читайте типы номеров, тарифные планы и номера и держите свою копию каждого бронирования в актуальном состоянии, кто бы его ни создал.
- Инструменты для переписки с гостями. Находите проживания по дате, имени гостя или собственному номеру и реагируйте, когда бронирование меняется.
- Инструменты для платежей и учёта. Читайте счёт гостя, добавляйте начисления, записывайте платежи и создавайте ссылки на оплату картой в собственном аккаунте Stripe отеля.
Два способа подключения
| Приложение (рекомендуется) | Закрытый ключ | |
|---|---|---|
| Для кого | ПО, которое вы предлагаете многим отелям | Один отель, работающий с вами напрямую |
| Как отель подключается | Нажимает Connect в каталоге приложений, затем Allow (OAuth 2.0) | Владелец создаёт ключ в Settings → Partner API и отправляет его вам |
| Учётные данные | Токен доступа cbat_... (1 час) и токен обновления | Ключ API cbk_... (действует, пока его не отзовут) |
| Права | Только scopes, разрешённые отелем | Всё в этом объекте |
Оба способа вызывают те же 25 операции по тому же базовому адресу, с той же идемпотентностью, лимитами и вебхуками. Каждые учётные данные действуют для одного объекта.
Как всё связано
- Вы регистрируете бесплатный аккаунт разработчика и получаете Sandbox Hotel с тестовыми данными и ключ API.
- Вы разрабатываете на тестовом отеле с этим ключом.
- Вы регистрируете приложение на странице Developers и получаете client ID и secret.
- Вы подключаете приложение к своему тестовому отелю через OAuth, чтобы проверить весь процесс.
- Вы отправляете приложение на проверку. Когда ChatBeds его одобряет, оно появляется в каталоге приложений каждого отеля.
- Отель подключает ваше приложение, ваш сервер обменивает код на токены и вызывает
/partner/v1для этого объекта. - ChatBeds отправляет на адрес вашего вебхука подписанное событие каждый раз, когда бронирование в этом объекте создаётся, меняется или отменяется.
Разработка бесплатна
Аккаунты разработчика и Sandbox Hotel бесплатны, за них никогда не выставляют счёт. Вы можете подключать свои приложения к своему тестовому отелю на любом этапе, ещё до проверки.
Что дальше
Быстрый старт
Первый вызов и первое бронирование за несколько минут.
Приложения и OAuth
Зарегистрируйте приложение, и любой отель сможет его подключить.
Справочник API
Все 25 операции с реальными запросами и ответами.
Вебхуки
Получайте события бронирований и проверяйте их подписи.
Руководства
Пошаговые разборы типичных интеграций.
Ресурсы
Ошибки, идемпотентность, лимиты, журнал изменений и поддержка.
Что-то создаёте?