ДокументацияСправочник REST API

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

6 минПоследнее обновление: 2026-03-31

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

Запросы к API требуют аутентификации с помощью JWT-токена или API-ключа:

Authorization: Bearer <jwt-token>
// ИЛИ
X-API-Key: af_<32-hex-chars>

Эндпоинт чата

POST /api/v1/chat/{agentUuid}
Content-Type: application/json

{
  "message": "Your question here",
  "sessionId": "optional-session-id",
  "stream": false
}

Ответ:

{
  "answer": "AI response text",
  "sessionId": "uuid",
  "tokensUsed": 142,
  "sources": [{"text": "...", "score": 0.92}]
}

Чат виджета (публичный)

POST /api/v1/chat/{agentUuid}/widget
// Аутентификация не требуется: заголовок Origin проверяется по белому списку доменов

CRUD агентов

POST   /api/v1/agents         - Создать агента
GET    /api/v1/agents         - Список ваших агентов
GET    /api/v1/agents/:id     - Данные агента
PUT    /api/v1/agents/:id     - Обновить агента
DELETE /api/v1/agents/:id     - Удалить агента (мягкое удаление)

Документы

POST   /api/v1/agents/:id/documents    - Загрузить файл (multipart)
GET    /api/v1/agents/:id/documents    - Список документов
DELETE /api/v1/agents/:id/documents/:id: Удалить документ

Лимиты запросов

Глобально: 100 запросов в минуту. Аутентификация: 10 в минуту. Чат: 30 в минуту.

Была ли эта статья полезна?