read-сценарий

Read-сценарий - это минимальный запрос на чтение бизнес-данных из API.

Простыми словами: это проверка, что интеграция не только авторизуется, но и получает полезный результат.

Рекомендуемый endpoint Метрики для первого отчета:

• GET /stat/v1/data

Минимальные параметры:

• ids - идентификатор счетчика;
• metrics - метрика(и) отчета;
• date1, date2 - период данных.

Пример cURL:

curl -sS -H "Authorization: OAuth <token>" -H "Accept: application/json" "https://api-metrika.yandex.net/stat/v1/data?ids=<counter_id>&metrics=ym:s:visits&date1=today-7&date2=today"

Что считается успешным:

• ответ 2xx;
• структура отчета валидна и содержит значения по запрошенной метрике.

Типовые причины сбоев:

• недоступный или неверный counter_id;
• невалидные metrics/даты;
• ограничения прав токена.

Практический вывод:

• Read-сценарий фиксирует базовую полезность интеграции.
• Для Метрики важно заранее согласовать "канонический" тестовый отчет для регресса.