API и интеграции

Подключите AI ASI Biont к любой системе — REST API, вебхуки и задачи по расписанию

Публичный REST API

Полноценный REST API по адресу /api/v1/* с аутентификацией по API-ключу. Управляйте чатом, миссиями, задачами, заметками, интеграциями и расписанием из любого HTTP-клиента.

Создайте API-ключ в дашборде. Ключи имеют префикс asb_ (64 hex символа, хранятся как SHA-256 хеш). Передавайте ключ в заголовке X-API-Key. Опционально: укажите область видимости (full, chat, webhook) и дату истечения.

Основные эндпоинты

POST /api/v1/chat — Чат с AI

GET /api/v1/missions — Список / запуск миссий

GET /api/v1/tasks — Список задач

GET /api/v1/notes — Список заметок

GET /api/v1/events — Журнал событий

POST /api/v1/schedule — Управление задачами по расписанию

POST /api/v1/keys/create — Управление API-ключами

POST /api/v1/webhooks/outgoing/register — Управление вебхуками

Исходящие вебхуки

Подпишитесь на события AI и получайте HTTP POST уведомления на ваш URL. Каждый вебхук подписывается HMAC-SHA256 — проверяйте подлинность на своей стороне.

Типы событий

mission_created — Создана новая миссия
task_completed — Задача завершена
ai_message — Сообщение AI в чате
reminder_triggered — Напоминание сработало
note_created — Создана заметка
scheduled_trigger — Задача по расписанию выполнена
integration_connected — Интеграция подключена

Каждый вебхук содержит заголовок X-ASI-Signature — HMAC-SHA256 от тела запроса, подписанный секретным ключом. Таймаут доставки — 15 секунд; без ответа HTTP 200 доставка считается неудачной. Автоматических повторов нет — эндпоинт должен быть идемпотентным.

Задачи по расписанию (Cron)

Планируйте выполнение AI-промптов по cron-расписанию. Укажите промпт и время — AI выполнит задачу, сохранит результат в заметки и пришлёт отчёт.

Примеры

0 * * * * — Каждый час

0 9 * * 1-5 — По будням в 9:00

0 8 * * 1 — Каждый понедельник в 8:00

Фоновый воркер проверяет задачи каждые 60 секунд. При срабатывании AI выполняет промпт, сохраняет ответ как заметку и генерирует событие scheduled_trigger (перехватывается вебхуками).

Система событий

Система событий — это центральная шина сообщений, соединяющая все компоненты ASI Biont. Построенная на архитектуре asyncio.Queue, она обеспечивает надёжную асинхронную доставку событий по всей платформе.

Архитектура

События помещаются в in-memory asyncio.Queue
Фоновый воркер обрабатывает события одно за другим
Каждое событие логируется в таблицу event_logs для аудита
Обработчики регистрируются через декоратор @EventSystem.on('event_type')

Формат события

{
    "user_id": 42,
    "event_type": "task_completed",
    "payload": {
        "task_id": 123,
        "title": "Analyze sales data",
        "status": "completed"
    }
}

Встроенные обработчики

Outgoing Webhooks — Доставляет события на зарегистрированные URL вебхуков с подписью HMAC-SHA256
Event Logging — Сохраняет каждое событие в БД для аудита и отладки

Готовы встроить AI в свой рабочий процесс?

Создайте API-ключ в один клик и начинайте разработку.

Перейти в дашборд Задать вопрос