Hostme API для партнёров
Документация для интеграций с платформой управления рестораном Hostme: бронирования,
доступность столов, гости и программа лояльности, меню и заказы. Все примеры построены
на реальной спецификации Hostme API v1.
Обновлено: 2026-06-25 13:29 MSK
Начало работы
Доступы, аутентификация, базовые понятия и быстрый старт.
Введение
Что такое Hostme API, для кого эта документация и как ей пользоваться.
Окружения и доступы
Боевое и тестовое окружения, базовые URL, как получить доступ.
Аутентификация
OAuth2 password flow, получение и обновление токена, типы токенов.
Быстрый старт
Сквозной пример: токен → проверка доступности → создание брони.
Соглашения: запросы и ответы
Формат запросов и ответов, дата/время, пагинация, идемпотентность.
Основные понятия
Рестораны, идентификаторы, гости, столы, время и часовые пояса.
Ошибки и коды ответов
HTTP-коды, формат ошибок, типичные причины и как их обрабатывать.
Бронирования
Доступность, создание и управление бронями, заявки, источники.
Доступность столов
Поиск свободных слотов и столов на дату для заданного размера компании.
Создание и управление
Создание, получение, изменение и отмена бронирований + справочник полей.
Запросы на бронь
Заявки на бронь с модерацией: создание, подтверждение, отклонение.
Партнёрские брони
Список броней, созданных через партнёрское приложение, и источники.
Гости
Гостевая книга: профили, поиск, история визитов, экспорт базы.
Меню и заказы
Каталог, модификаторы, налоги и инвентарь.
Операции
Лист ожидания, столы и залы, события ресторана.
Платежи и настройки
Депозиты, профиль ресторана, регистрация приложения, уведомления.
Оплаты и депозиты
Депозиты, предоплаты и платёжные настройки бронирований.
Информация о ресторане
Профиль ресторана, рабочие часы и базовые настройки.
Регистрация приложения
Регистрация приложения, партнёрский токен и идентификаторы.
Сообщения и уведомления
Уведомления и рассылки гостям (указатель на возможности платформы).
Справочник
Версионирование и история изменений.