Справочник 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 в минуту.