ВнедрениеREST API
REST API
Программный доступ к поиску, агентам и загрузке знаний.
REST API v1 — программный доступ ко всем возможностям платформы: от загрузки документов до диалога с агентом. Все примеры в этом разделе — реальные пути и форматы API.
Базовый URL: https://api.cosai.pro/v1
Аутентификация: заголовок Authorization: Bearer <api-key> (см. Аутентификация)
Основные группы методов
| Группа | Методы | Назначение |
|---|---|---|
| Базы знаний | GET/POST /sources, POST /sources/:id/files, POST /sources/:id/documents, GET/DELETE /documents/:id, GET /jobs/:id, GET /jobs/recent | Создание баз знаний, загрузка и статус индексации документов |
| Поиск | POST /search | Гибридный поиск по базе знаний напрямую, без диалога с агентом |
| Агенты | GET/POST/PATCH /agents, POST /agents/:id/chat, POST/GET /agents/:id/eval, POST /agents/:id/publish | Создание и настройка агентов, диалог, проверка качества, публикация |
| Скиллы | GET/POST /skills | Компетенции агентов |
| Онбординг | POST /onboarding | Мастер «отрасль + документы → работающий агент» одним запросом |
| Учёт | GET /usage, GET /models | Потребление за 30 дней, доступный каталог моделей |
Полный перечень эндпоинтов с точными схемами запросов и ответов — в автоматическом справочнике API Reference, который генерируется из спецификации API.
Формат ошибок
| Код | Значение |
|---|---|
| 401 | ключ не указан или не распознан |
| 403 | домен не в allowlist виджет-ключа, либо агент не опубликован для публичной поверхности |
| 404 | сущность не найдена |
| 409 | eval-гейт: попытка опубликовать агента без пройденной проверки |
| 422 | ошибка валидации входных данных |
Дальше: Аутентификация и Примеры запросов.