AGIL Calls API Explorer

С чего начать (5 шагов)

1. Админский ключ. x-api-key — только на сервере компании, никогда в браузере (dev: dev-key).
2. Создать комнату. POST /v1/rooms → room.id, joinUrl, embedUrl; пароль опционален.
3. Выдать токен. POST /v1/tokens с participant и permissions (или roleId) → короткоживущий token.
4. Встроить звонок. SDK /sdk/agil-calls.js (AGILCalls.mount) или iframe /embed.html?room=…&token=….
5. Настроить политику. /v1/admin/access-policy, /v1/admin/roles, /v1/admin/providers, /v1/admin/scale, вебхуки; следить через /v1/admin/audit.

Авторизация

• x-api-key — админский ключ тенанта для /v1/admin/* и POST /v1/tokens. Только сервер компании.
• authorization: Bearer <join token> — участник: WS, чат, файлы, записи, STT, ассистент. Токен выдаёт ваш сервер.
• ?sig=&exp= — подписанные ссылки на файлы/записи (TTL).
• Права = роль → исключения → права токена → запреты → включённые фичи (docs/contract.md §18).

Коды ошибок

Ссылки

• Руководство: с чего начать, роли, встраивание
• Полный справочник REST + WebSocket
• Контракт монорепо
• Безопасность и аудит
• Провайдеры и автономность
• openapi.json (публичная спека) · openapi.admin.json
• MCP: node packages/mcp/dist/index.js (stdio) — инструменты для нейросетей.

Документы компании

Основной документ: AGIL Calls API — понятное руководство (для человека и программиста) (api-guide.md)

• AI-агент AGIL Calls: архитектура, интеграция, приватность ai-agent.md
• API-документация и MCP: публикация, нейросети, защита доступа api-exposure.md
• AGIL Calls API — понятное руководство (для человека и программиста) основной api-guide.md
• AGIL Calls — API (REST + WebSocket) api.md
• AGIL Calls — архитектура (этап 1: браузер) architecture.md
• AGIL Calls — что ещё осталось сделать (backlog) backlog.md
• AGIL Calls — gap-анализ против конкурентов competitor-gaps.md
• AGIL Calls — контракт монорепо (для команды и для агентов) contract.md
• Маскот-помощник «Agil», DeepSeek-чат и guard критических изменений dashboard-assistant.md
• Экран «Документация» в панели dashboard-docs.md
• Панель разработчика AGIL Calls — экраны, API и оффлайн-поведение dashboard.md
• Деплой AGIL Calls — calls.guardify.ru deployment-record.md
• AGIL Calls — запуск и эксплуатация deployment.md
• Дизайн-система панели AGIL Calls design-system.md
• Визуальный редактор панели AGIL Calls (`apps/editor`) editor.md
• AGIL Calls в Electron (и других браузерных обёртках) electron.md
• AGIL Calls — оценка сроков estimate.md
• Расширяемость: встроенные инструменты и заменяемые провайдеры extensibility.md
• AGIL Calls — матрица фич и паритет с конкурентами features.md
• AGIL Calls frontend — архитектура виджета frontend.md
• In-call AI-агент, права пользователя и spotlight-подсказки in-call-agent.md
• AGIL Calls ↔ приложение компании: границы и API integration-boundaries.md
• Кастомизация лейаута: стили контролов, «плавающий остров», скрытие кнопок layout.md
• Подключение любых нейросетей (модели, MCP, вебхуки) llm-integrations.md
• Локализация интерфейса AGIL Calls localization.md
• AGIL Calls MCP server mcp.md
• Интеграция звонков в корпоративный мессенджер messenger.md
• Производительность: бюджеты, память, CPU performance.md
• QA AI-функций AGIL Calls (заметки, compliance, in-call ассистент, knowledge, AI-агент) qa-ai.md
• QA: серверная часть и ошибки подключения (live stand) qa-backend.md
• QA дизайна CALL UI — AGIL Calls (live) qa-call-design.md
• QA панели разработчика AGIL Calls qa-dashboard.md
• QA: визуальный редактор AGIL Calls (`apps/editor`) — тотальный прогон qa-editor.md
• Функциональный QA AGIL Calls — стенд calls.guardify.ru qa-functional.md
• AGIL Calls — аудит иконок (visual QA: icons) qa-icons.md
• Наивный QA: повторная проверка AGIL Calls (retest) qa-naive-retest.md
• Наивный QA: AGIL Calls / Guardify qa-naive.md
• Security QA AGIL Calls — стенд `https://calls.guardify.ru` qa-security.md
• UX/QA-ревью панели-маскота «Agil» в AGIL Calls qa-ux-mascot.md
• AGIL Calls — визуальный QA и дизайн-критика qa-visual.md
• QA виджета и демо — тотальная проверка (widget/demo) qa-widget.md
• Реверс-инжиниринг аналогов и технологический разбор для AGIL Calls reverse-engineering.md
• Роли и права: встроенные и свои роли roles.md
• AGIL Calls как SaaS: мультиорганизационность saas.md
• Масштабирование: тысячи участников, мульти-нода, TURN-пул, SFU и стримы scaling.md
• AGIL Calls SDK — документация интегратора sdk.md
• AGIL Calls — модель угроз и аудит безопасности security-audit.md
• Безопасность AGIL Calls security.md
• AGIL Calls — технический спайк: SFU/LiveKit, мульти-нода, мобильные SDK sfu-plan.md
• SFU / LiveKit smoke test — S0 report sfu-smoke.md
• Выбор технологического стека и анализ фреймворков stack-analysis.md
• Тестовые данные и тестовая БД test-data.md

Редактирование и версии — в панели: GET/PUT /v1/admin/docs.