API и интеграции
Внутренние API уже используются продуктом. Публичный стабильный контракт для внешних разработчиков и MCP пока требует отдельной стабилизации.
Авторизация
Пользовательский вход работает через email/password и поток подтверждения. Публичные API-ключи для внешних агентов пока не оформлены.
available / gap
Финансовые API
Доступны внутренние API для дашборда, качества данных, рекомендаций, ручного ввода, предпросмотра импорта, импорта и предпросмотра синхронизации с CRM.
beta
Подтверждения
В продукте есть подход с подтверждениями для Telegram, паттернов и потоков с ручным контролем. Для внешнего API нужен единый публичный контракт.
internal
Внешние интеграции
Карты, Telegram и подготовка слоя CRM-адаптеров уже есть. Подключение новых внешних систем требует настройки и проверки контракта.
beta
Подключение агента
Минимальный путь подключения: клиент в песочнице, agent_key, самопроверка, тестовый запрос на подтверждение и проверка события в журнале действий.
beta/internal
Самопроверка в песочнице
POST /api/agent-api/self-test проверяет ключ, статус и права доступа агента, возвращает доступные безопасные действия и пишет тестовое событие в журнал действий.
beta/internal
Как подключить агента
# 1. Прочитать контракт Agent API curl -s "https://localos.pro/api/agent-api/openapi.json" # 2. Проверить политику безопасности curl -s "https://localos.pro/api/agent-api/security/policy" # 3. Запустить самопроверку в песочнице curl -s -X POST "https://localos.pro/api/agent-api/self-test" \ -H "X-LocalOS-Agent-Key: $LOCALOS_AGENT_KEY" \ -H "Content-Type: application/json" \ -d '{"purpose":"подключение в песочнице","checks":["auth","scopes","ledger"]}' # 4. Создать безопасный тестовый запрос на подтверждение curl -s -X POST "https://localos.pro/api/agent-api/approvals/request" \ -H "X-LocalOS-Agent-Key: $LOCALOS_AGENT_KEY" \ -H "Content-Type: application/json" \ -d '{"action_type":"test_publish_review_reply","capability":"reviews.reply.publish","risk_level":"high","requested_scope":"publish:request","input_summary":{"source":"быстрый старт в песочнице"},"proposed_output":"Только тестовый запрос на подтверждение."}' # 5. Запросить рабочий доступ после проверки в песочнице curl -s -X POST "https://localos.pro/api/agent-api/clients/promotion/request" \ -H "X-LocalOS-Agent-Key: $LOCALOS_AGENT_KEY" \ -H "Content-Type: application/json" \ -d '{"requested_scopes":["audit:read","reviews:draft","approvals:create"],"use_case":"Читать аудиты и готовить черновики ответов на отзывы под подтверждением человека.","contact":"ops@example.com"}'