📚 BusinessPlatform Docs

REST API

📘 Раздел для разработчиков. Если вы пользователь BusinessPlatform — здесь нет ничего, что нужно вам для работы. Этот раздел нужен, если вы или ваш программист хотите подключить наш кабинет к другим системам.

Все операции Control Panel доступны через HTTP. Аутентификация — cookie (для Control Panel) или Bearer-токен (для интеграций).

📹 ВидеоЗа 30 сек: получаем Bearer-токен, делаем `GET /api/business` через curl, показываем JSON-ответ со списком бизнесов, затем `POST /api/business/{id}/appointments` создаёт запись.
HTTP-запросGET/POST на /api/…
Авторизацияcookie или Bearer svc_xxx
Проверка доступак бизнесу пользователя
Ответ JSONданные или ошибка
Аудитсобытие в /audit

Base URL

https://businessplatform.ru/api

Аутентификация

POST /api/auth/login-link
Content-Type: application/json

{ "email": "you@example.com" }

На указанный email уйдёт ссылка https://irisaicrm.shop/auth/magic?token=<...>. Клик ставит cookie BusinessPlatform.Auth (живёт 7 дней) и редиректит в /ControlPanel. Токен одноразовый, TTL 15 минут. Регистрация — POST /api/auth/register: создаёт юзера + сразу логинит + шлёт письмо подтверждения email.

Bearer (для интеграций)

Service-token в заголовке Authorization: Bearer svc_xxx. Создание токенов — через service_tokens таблицу или config AIRouter:ServiceToken.

💡 Для интеграций с AI-ассистентом удобнее выпускать и отзывать ключи прямо в кабинете — раздел [MCP-токены](cp-mcp-tokens.md) («Настройки → MCP-токены»), там каждый токен привязан к пользователю и ротируется в один клик.

Основные ресурсы

Метод Путь Описание
GET /business Список моих бизнесов
GET /business/{id} Детали бизнеса
POST /business Создать бизнес
PUT /business/{id} Обновить бизнес (все поля опциональны)
GET /business/{id}/catalog Каталог услуг и товаров
POST /business/{id}/catalog Создать позицию каталога
GET /business/{id}/staff Сотрудники
GET /business/{id}/resources Ресурсы
GET /business/{id}/appointments Записи
POST /business/{id}/appointments Создать запись
GET /business/{id}/orders Заказы
POST /business/{id}/orders Создать заказ
GET /business/{id}/clients Клиенты
GET /business/{id}/audit Журнал событий

Публичные (без auth)

Метод Путь Описание
GET /public/availability Слоты для публикованного бизнеса
POST /public/book Создать запись с агрегатора
POST /public/order Создать заказ с агрегатора
GET /tariffs Список тарифов

Widget API (токен виджета)

См. Виджет. Endpoints под /api/widget/*.

Swagger

В dev-режиме доступна автогенерируемая документация: /swagger.

Rate limiting

В MVP отсутствует. В v1 планируется 100 req/min на токен.