# Получение показателя ERR для канала в динамике
Описание
Метод позволяет получить показатель "ERR" в динамике по дням, неделям, месяцам.
Метод доступен в "API Stat" (на тарифах S и выше)
# Запрос
# URL запроса
https://api.tgstat.ru/channels/err
# Параметры
Параметр | Описание | Значение по умолчанию | Обязательно |
---|---|---|---|
token | Ваш токен | Не задан | Да |
channelId | Идентификатор канала (@username, t.me/username, t.me/joinchat/AAAAABbbbbcccc... или ID канала в TGStat) | Не задан | Да |
startDate | Дата с (timestamp) | Не задан | Нет |
endDate | Дата по (timestamp) | Не задан | Нет |
group | Группировка результатов (day, week, month) | day | Нет |
Для группировки group=day
будет возвращено значение показателя ERR по состоянию на конец суток.
Для группировок group=week
и group=month
будет возвращено значение показателя ERR на конец последних суток периода (недели или месяца).
# Ответ
# Структура
{
"status": "ok",
"response": [ # Массив данных по дням, неделям или месяцам
...
]
}
# Пример ответа с группировкой по дням
{
"status": "ok",
"response": [
{
"period": "2021-11-26",
"err": 41
},
{
"period": "2021-11-25",
"err": 41.4
},
{
"period": "2021-11-24",
"err": 40.9
},
...
]
}
По умолчанию вернется результат за 10 последних дней.
Однако, вы можете указать необходимый период с помощью параметров startDate
и endDate
, соблюдая при этом ограничения на вашем тарифе.
В зависимости от запрошенного типа группировки group
- поле period
будет принимать один из форматов:
"Y-m-d" # для group=day
"Y-W" # для group=week
"Y-m" # для group=month
Y - Порядковый номер года, 4 цифры
m - Порядковый номер месяца с ведущим нулём
d - День месяца, 2 цифры с ведущим нулём
W - Порядковый номер недели года в соответствии со стандартом ISO-8601; недели начинаются с понедельника
# Подробнее о форматах даты http://php.net/manual/ru/function.date.php