Когда документы кампании, персоны и тест креатива уже работают в UI, типичный следующий шаг — подключить внешние системы: Google Drive с CSV метрик, CRM, ETL или Google Apps Script. Для этого в Adminica есть inbound webhook, очередь загрузки и публичная OpenAPI-схема.

Три точки входа

Способ	Endpoint	Когда использовать
UI в ЛК	`POST /api/v1/analytics/ingest`	Ручной импорт, JWT-сессия
Inbound webhook	`POST /api/v1/analytics/ingest/webhook`	Drive, Zapier, cron, Apps Script
OpenAPI	`GET /api/v1/openapi/integrations.json`	Postman, codegen, документация для интегратора

Webhook создаёт job и сразу ставит его в очередь на обработку: CSV → документ типа metrics в персональной библиотеке, привязанный к campaign_id при необходимости.

Аутентификация

API key — заголовок X-API-Key: ak_… или Authorization: Bearer ak_… (ключ из Профиль → Безопасность).
HMAC (опционально) — подпись X-Adminica-Signature по телу запроса; секрет задаёт администратор на стороне сервера.

Без ключа webhook отвечает 401 — это ожидаемое поведение для smoke-проверки.

Пример: Google Drive push

POST https://adminica.ru/api/v1/analytics/ingest/webhook
X-API-Key: ak_…
Content-Type: application/json

{
  "event": "drive.file.updated",
  "label": "Q1 metrics",
  "campaign_id": "spring-family-2026",
  "file": {
    "name": "metrics.csv",
    "mimeType": "text/csv",
    "content": "metric,value\nCTR,1.2%\n"
  }
}

Плоский формат (file_name, mime_type, content на верхнем уровне) и email/CSV payload тоже поддерживаются — source_type определяется автоматически.

OpenAPI для интеграторов

Эндпоинт /api/v1/openapi/integrations.json доступен в prod (read-only, без Swagger UI). В схеме — все /analytics/*, исходящие /webhooks и /scheduled-queries. Импортируйте в Postman или сгенерируйте клиент на своём языке.

Человекочитаемый гайд с примерами creative review и ingest — на /docs/18-rest-api/#analytics.

Чеклист подключения (<30 мин)

Выпустить API key в профиле; убедиться, что сценарий «Тест креатива» доступен в вашем контуре (или у администратора).
Скачать схему: curl -s https://adminica.ru/api/v1/openapi/integrations.json | jq .info
Отправить тестовый webhook с CSV из примера выше — ответ 201, job pending → done.
Проверить документ metrics в Профиль → Документы и фильтр по кампании.
Для creative review — POST /api/v1/analytics/creative-review с panel_id из GET /analytics/panels.

Итог: цикл «метрики извне → база кампании → тест креатива» закрывается через webhook, OpenAPI и тот же on-prem контур, что UI и MCP.