Admin API: логи и диагностика

Через API доступны те же данные, что в разделе панели Логи и на странице Состояние системы. Все десять методов требуют токен с доступом Полный доступ (full): с другим доступом приходит 403 token_scope. При неактивной лицензии методы отвечают 402 — см. Истёкшая лицензия. Авторизация описана на странице Admin API: обзор и авторизация, формат ответов и общие коды ошибок — на странице Формат запросов, ответов и ошибок.

Клики

Найти клики

GET /api/v1/logs/clicks

Возвращает клики за период. Можно отобрать клики по точному IP, subid или external_id. Правила поиска те же, что на вкладке Клики и лиды.

Ответ — код 200:

Пример запроса:

curl "https://panel.example.com/api/v1/logs/clicks?from=2026-10-01T00:00:00Z&to=2026-10-04T00:00:00Z&field=ip&value=203.0.113.10&limit=50" \
  -H "Api-Key: <токен>"

Пример ответа, часть полей клика опущена:

{
  "items": [
    {
      "subid": "k3x9m2q7c1ab",
      "ts": "2026-10-03T14:22:05.418Z",
      "ip": "203.0.113.10",
      "campaign_id": "c41a9e07-52bd-4f13-8a60-9d7e6f5a4b3c",
      "stream_id": "5e2d7a10-8c4b-4f6e-b1a9-0d3c2b1a4f5e",
      "country": "PL",
      "is_bot": false,
      "is_unique": true,
      "tokens": {"external_id": "ext-448812"}
    }
  ],
  "next_cursor": "",
  "names": {"c41a9e07-52bd-4f13-8a60-9d7e6f5a4b3c": "FB PL Nutra"}
}

Ошибки:

Карточка клика

GET /api/v1/logs/clicks/{id}

Возвращает клик, его переходы с лендинга и конверсии — данные карточки клика. Клик ищется по всей сохранённой истории, период не нужен.

Ответ — код 200:

Истории доставки событий в ответе нет: её отдаёт GET /api/v1/deliveries/search с параметром click_id — см. Admin API: конверсии и постбек. Данные лида отдаёт GET /api/v1/reports/click-lead — см. Admin API: отчёты.

Ошибки:

Журнал действий

GET /api/v1/logs/audit

Возвращает записи журнала действий пользователей, новые первыми.

Ответ — код 200: объект с полями items, total — число записей по фильтру, page и limit.

Пример запроса — неудачные изменения кампаний за сутки:

curl "https://panel.example.com/api/v1/logs/audit?resource=campaigns&outcome=error&from=2026-10-03T00:00:00Z&to=2026-10-04T00:00:00Z&limit=50" \
  -H "Api-Key: <токен>"

Ошибки — код 422, code validation:

Потоковые журналы

Четыре журнала: system — системный лог, postback — входящие постбеки, s2s — исходящие S2S, traffic — журнал трафика. Что в них пишется — на странице Системный лог, постбэки и журнал трафика. В каждом журнале хранятся 2000 последних записей, журналы общие для всей установки.

Прочитать журнал

GET /api/v1/logs/{stream}

Возвращает записи журнала, новые первыми.

Ответ — код 200 и массив записей. Если записей нет, приходит [].

Ошибка: 404, code not_found, message неизвестный поток логов — в stream значение не из списка.

Очистить журнал

DELETE /api/v1/logs/{stream}

Удаляет все записи журнала для всей установки. Параметр пути stream — тот же, что при чтении.

Ответ — код 204 без тела.

Узнать, включён ли журнал трафика

GET /api/v1/logs/traffic-enabled

Параметров нет. Ответ — код 200:

{"enabled": false}

Включить или выключить журнал трафика

PUT /api/v1/logs/traffic-enabled

Переключает запись журнала traffic — то же, что тумблер Логировать на вкладке Трафик.

Ответ — код 200 и объект {"enabled": true} с новым значением.

Ошибка: 400, code bad_request, message invalid json — тело не разобрано.

Диагностика

Состояние очередей

GET /api/v1/queue-health

Возвращает очередь приёма кликов и незавершённые задачи доставки — данные вкладки Состояние очередей.

Параметров нет. Ответ — код 200:

Ошибка: 503, code unavailable — очередь доставки не прочитана. В ответе есть заголовок Retry-After: 5: повторите запрос через 5 секунд.

Состояние системы

GET /api/v1/system-health

Возвращает данные страницы Состояние системы: сборку, сервисы, фоновые задачи и выгрузки.

Параметров нет. Метод отвечает кодом 200 и при недоступном сервисе: смотрите поле state.

Имена задач в workers: report_exports, deliveries, target-monitor, retention, domain-checks. stale равно true, если последний отклик старше 3 минут.

Применение настроек трафика

GET /api/v1/runtime-config

Показывает, дошли ли изменения кампаний, потоков и доменов до серверов обработки трафика. Как читать статусы — на странице Серверы обработки трафика.

Параметров нет. Ответ — код 200:

Поля сервера в nodes: node — имя, revision — подтверждённая версия, checked_at — последний отклик, поля нет у сервера без единого отклика, expected — входит ли в список ожидаемых, stale — нет свежего отклика, instances — сколько работающих серверов назвались этим именем, state — состояние:

Ошибка: 503, code config_unavailable, message Состояние конфигурации недоступно.