Доступ через EASY ID
Прикладные API доступны только активным сотрудникам после входа через Bitrix24. Cookie сессии передаётся браузером. Для POST получите CSRF из GET /api.php?action=session и передавайте его в X-AZOT-CSRF. Машинный API-ключ браузеру не выдаётся.
Маршруты
- GET /v1/capabilities, /v1/collections, /v1/usage
- POST /v1/agent/run — задача или диалог; task, language, max_steps, history (до 6 сообщений user/assistant по 1000 символов)
- POST /v1/agent/runs — фоновая задача без history
- GET /v1/agent/runs и /v1/agent/runs/{uuid}
- POST /v1/agent/runs/{uuid}/cancel
- GET /v1/knowledge/search?q=…
- POST /v1/knowledge/answer, /v1/web/search, /v1/web/answer
- POST /v1/documents/ocr, /v1/audio/transcriptions — multipart с полем file
- GET /v1/jobs/{uuid}, /v1/files, /v1/files/{uuid}, /v1/files/{uuid}/content
- POST /v1/files/{uuid}/structure, /v1/files/{uuid}/formulas
Долгие запросы
Если ответ не готов за 20 секунд, API возвращает 202 с id и status_url. Выполняйте GET status_url до state=done или failed. Результат находится в response: status — исходный HTTP-код, content_type — тип данных, body — тело в Base64. Не повторяйте исходный POST автоматически.
Альтернативный асинхронный транспорт: POST /api.php?action=request с JSON {method, path, content_type, body}, где body — Base64. Он сразу выдаёт билет. Получить результат может только создатель запроса.
Ограничения первого выпуска
Загрузка через форму: 7 МБ; тело API: 8 МБ; ответ: 10 МБ. До трёх активных запросов на сотрудника и 30 запросов в минуту. Билеты и результаты на шлюзе удаляются через 30 минут. При выключенном компьютере — 503. Служебные API, база данных и модель напрямую не публикуются. Чтение задач Bitrix24 через общий технический ключ закрыто для веб-пользователей до настройки проверки прав каждого сотрудника. Поддерживаемые языки: ru, kk, en, uz.
English: authenticated EASY ID session and X-AZOT-CSRF are required. Long calls return an asynchronous ticket. Қазақша: EASY ID арқылы кіру қажет. O‘zbekcha: EASY ID orqali kirish talab qilinadi.