API и вебхуки
Открытый API, ключи, вебхуки, MCP и документация для ваших интеграций
Справочник методов
Разделы методов API — параметры и примеры ответов
Свой виджет записи
Порядок вызовов для формы записи на своём сайте — услуги → мастера → свободные окна → запись
GET /api/v1/services
GET /api/v1/staff?service_id=42
GET /api/v1/slots?staff_id=7&date=2026-09-26
POST /api/v1/bookings { "staff_id": 7, "service_id": 42, "start": "2026-09-26T14:00:00+04:00" }ИИ-боты и автономные агенты
Тот же API, что видит виджет записи
Внешний бот получает свободные окна через тот же GET /api/v1/slots, что и виджет записи — занятый слот не предлагается. Услуга, скрытая из онлайн-записи, ботом тоже не отдаётся (нет в GET /api/v1/services) — так прячут «внутренние» услуги.
Флаги уведомлений при записи через API
Решают, слать ли клиенту и мастеру обычные уведомления о записи, созданной внешней программой
notify_client— уведомить клиента (если канал уже включён в филиале)notify_staff— уведомить мастера
Состояние платформы
Доступность API и вебхуков, журнал сбоев
Протокол маркетплейса
Активация, оплата, возврат и публикация телефонии
Запрос активации
POST https://app.example.am/marketplace/partner/callback
Authorization: Bearer <Partner Token>
{ "salon_id": 123, "application_id": 45 }Ответ 201 в течение часа после согласия пользователя включает интеграцию; позже — ошибка
Оплата подписки через API
Присылайте каждый раз, когда владелец платит — иначе интеграция отключится по истечении срока
Возврат и смена цены
Возврат по номеру транзакции отключает интеграцию не позже чем через час; смену цены оформляйте новым платежом
Публикация телефонии
Активация и отключение АТС проходят по тому же протоколу, что и остальные приложения
Поддержка разработчиков
Вопросы по API — на api-support@example-booking.am, приложите адрес запроса, заголовки и оба токена.