Получение таймсерий метрик для дэшборда

Описание

Возвращает метрики в виде точек времени (таймсерий) для построения графиков. Период задаётся через start_date и end_date, а шаг агрегации — через group_ts (например, по дням). При необходимости можно сузить расчёт до конкретной модели и окна атрибуции.

URL-адрес

POST/catboss/metrics/dashboard

Параметры запроса

Тело запроса (JSON):

Параметр	Тип	Пример	Обязательный	Описание
metrics	array	["ctr","revenue","cr"]	Да	Список метрик
start_date	integer	1740125112	Да	Начало периода (Unix timestamp / int64)
end_date	integer	1742727112	Да	Конец периода (Unix timestamp / int64)
model	string	last	Нет	Название модели (last, first, random)
attr_windows	integer	604800	Нет	Окно атрибуции (int64) — 10800, 86400, 604800, 2592000

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

bash

curl -X POST "https://example.com/api/catboss/metrics/dashboard" \
  -H "X-MOODREC-API: <token>" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "metrics": ["ctr", "revenue"],
    "start_date": 1740125112,
    "end_date": 1742727112
  }'

Пример ответа

json

{
  "metrics": [
    {
      "name": "ctr",
      "unit": "%",
      "non_rec": 1.12,
      "rec": 1.45,
      "uplift": 0.29,
      "value": "1.45",
      "ts": 1740125112
    },
    {
      "name": "ctr",
      "unit": "%",
      "non_rec": 1.10,
      "rec": 1.40,
      "uplift": 0.27,
      "value": "1.40",
      "ts": 1740211512
    }
  ]
}

Возвращаемые параметры

Параметр	Тип	Описание
metrics	array	Список метрик (точки таймсерии)
metrics[].name	string	Название метрики
metrics[].unit	string	Единицы измерения
metrics[].non_rec	number	Значение без рекомендаций
metrics[].rec	number	Значение с рекомендациями
metrics[].uplift	number	Относительное изменение (uplift)
metrics[].value	string	Представление значения в виде строки
metrics[].ts	integer	Таймстемп точки (int64)