Справочник API
Интерактивная документация
Полный справочник всех 126 endpoints доступен через Swagger UI:
https://your-server/swagger/index.html
Или в формате ReDoc:
https://your-server/api/documentation
Основные группы endpoints
| Группа | Базовый путь | Описание |
|---|---|---|
| Авторизация | /api/auth/* | Регистрация, вход, выход, 2FA |
| Профиль | /api/me/* | Профиль, пароль, сессии, мют |
| Чаты | /api/chats/* | CRUD чатов, участники, сообщения |
| Файлы | /api/files/* | Загрузка, скачивание, список |
| Команды | /api/teams/* | Команды, каналы, посты, wiki |
| Календарь | /api/calendar/* | События, участники, RSVP |
| Звонки | /api/chats/:id/call/* | Начало, завершение, участники |
| Webhooks | /api/chats/:id/webhooks | Управление вебхуками |
| OAuth | /api/oauth/* | SSO провайдеры |
| Админ | /api/admin/* | Dashboard, пользователи, настройки |
Пагинация
Списковые endpoints поддерживают:
page— номер страницы (с 1)limit— записей на страницу (макс. 200)
Ответ:
{
"items": [...],
"page": 1,
"limit": 50,
"total": 234,
"totalPages": 5
}
Формат ошибок
{
"error": "описание ошибки"
}
HTTP-коды: 400 (невалидные данные), 401 (не авторизован), 403 (запрещено), 404 (не найдено), 500 (ошибка сервера).