Обзор API

Базовый URL

https://api.smaiwer.ru

Для self-hosted установок используйте URL вашего сервера.

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

API использует cookie-based аутентификацию. После входа сессия сохраняется в cookie.

Пример входа

curl -X POST https://api.smaiwer.ru/api/client/login \
  -H "Content-Type: application/json" \
  -c cookies.txt \
  -d '{
    "organization_id": "your-org-id",
    "username": "admin",
    "password": "your-password"
  }'

Подробнее: Аутентификация

Формат ответов

Все ответы в формате JSON:

Успешный ответ

{
  "status": "success",
  "data": {
    // данные
  }
}

Ошибка

{
  "status": "error",
  "message": "Описание ошибки"
}

HTTP коды

Код	Описание
200	Успешный запрос
201	Ресурс создан
400	Неверный запрос
401	Не авторизован
403	Доступ запрещён
404	Не найдено
429	Слишком много запросов
500	Внутренняя ошибка сервера

Rate Limiting

• Стандартные запросы: 100/минуту
• Загрузка файлов: 10/минуту
• AI запросы: 20/минуту

При превышении лимита возвращается 429 Too Many Requests.

Разделы API

Раздел	Описание
Аутентификация	Вход, выход, сессии
Чаты	Список чатов, информация о пользователях
Сообщения	Отправка, получение сообщений
AI	AI ассистент, генерация изображений
База знаний	Управление статьями
WebSocket	Real-time уведомления
Виджет	Публичный API виджета