Справочник REST API

Все эндпоинты API имеют префикс /api/ и требуют аутентификации через сессионный cookie. Все запросы и ответы используют Content-Type: application/json.

---

Беседы

Эндпоинт	Метод	Описание
/api/conversations	GET	Список бесед (фильтры: status, channel_type, tag, search, page)
/api/conversations/{id}	GET	Получить беседу (сбрасывает unread_count)
/api/conversations	POST	Создать беседу
/api/conversations/{id}/status	POST	Обновить статус
/api/conversations/{id}/tags	POST	Добавить тег
/api/conversations/{id}/tags/{tag}	DELETE	Удалить тег
/api/conversations/{id}/assign	POST	Назначить агента

Сообщения

Эндпоинт	Метод	Описание
/api/conversations/{id}/messages	GET	Список сообщений
/api/conversations/{id}/messages	POST	Отправить сообщение

Предложение ИИ

Эндпоинт	Метод	Описание
/api/ai-suggest?conversation_id={id}	GET	Получить предложение ответа ИИ

Контакты

Эндпоинт	Метод	Описание
/api/contacts	GET	Список контактов
/api/contacts/{id}	GET	Получить контакт
/api/contacts	POST	Создать контакт
/api/contacts/{id}	PATCH	Обновить контакт
/api/contacts/{id}	DELETE	Удалить контакт (админ)

Каналы (только админ)

Эндпоинт	Метод	Описание
/api/channels	GET	Список каналов
/api/channels	POST	Создать канал
/api/channels/{id}	PATCH	Обновить канал
/api/channels/{id}	DELETE	Удалить канал

Автоматизации (только админ)

Эндпоинт	Метод	Описание
/api/automations	GET	Список автоматизаций
/api/automations	POST	Создать автоматизацию
/api/automations/{id}/toggle	POST	Переключить активность
/api/automations/{id}	DELETE	Удалить автоматизацию

Аналитика

Эндпоинт	Метод	Описание
/api/analytics?days=30	GET	Получить данные аналитики

Агенты (только админ)

Эндпоинт	Метод	Описание
/api/agents	GET	Список агентов
/api/agents	POST	Создать агента
/api/agents/{id}/role	POST	Обновить роль
/api/agents/{id}	DELETE	Удалить агента

Настройки

Эндпоинт	Метод	Описание
/api/settings/workspace	GET	Получить настройки рабочего пространства
/api/settings/workspace	POST	Обновить рабочее пространство (админ)
/api/settings/password	POST	Изменить пароль

---

Формат ошибок

{"error": "Human-readable error message"}

Код	Значение
200	Успех
201	Создано
400	Неверный запрос
401	Не аутентифицирован
403	Запрещено
404	Не найдено
409	Конфликт
500	Внутренняя ошибка