Форматы данных

Запросы и ответы

• Адрес — https://api.datool.ru/v1/…, только HTTPS.
• Ключ — в заголовке Authorization: Bearer dtk_… (или X-API-Key: dtk_…).
• Ответы — JSON в UTF-8. Тело запроса (вебхуки) — JSON с заголовком Content-Type: application/json.
• Язык текстов ошибок и описаний — по заголовку Accept-Language: en — по-английски, иначе по-русски. Данные (названия каналов, тексты постов, названия рубрик) — как в MAX.

Время и даты

• Моменты времени — ISO 8601 с часовым поясом, по Москве: 2026-10-18T11:42:00+03:00. Программа, которая понимает ISO 8601, переведёт их в любой пояс сама. Исключение — заголовок X-Quota-Reset: он в UTC (2026-11-04T10:20:00Z).
• Дни (статистика, фильтры from и to) — ГГГГ-ММ-ДД по московскому времени: 2026-10-17.

Номера

• id — номер в datool.ru (канала, поста, рубрики, вебхука). Им пользуются в адресах и фильтрах API.
• external_id — номер в MAX: у канала — ID чата со знаком минус (-71204896310021), у поста — номер поста в канале.

Значения

• null — значения нет или оно неизвестно: например, subscribers: null — канал в этот день не опрашивали.
• Да / нет — true / false.
• Деньги (баланс в /v1/me/) — строка с двумя знаками после точки, в рублях: "1490.00".
• Реакции — объект «эмодзи → число»: {"👍": 180, "🔥": 56}.

Совместимость

Новые поля и методы появляются в v1 без смены версии. Пишите клиент так, чтобы незнакомые поля в ответе не ломали разбор.