Справочник API
REST API версии v1. Авторизация — токеном проекта в заголовке Authorization: Bearer.
Базовый адрес
https://api.ru-stats.example/v1
Отправить события
POST /v1/events — принимает пакет событий, отвечает 202 Accepted.
Отчёт по проекту
GET /v1/projects/{id}/report?from=2026-11-01&to=2026-11-22&metric=pageviews
Authorization: Bearer $PROJECT_TOKEN
{
"project": "demo",
"metric": "pageviews",
"granularity": "day",
"points": [{"ts": "2026-11-21", "value": 184203}, {"ts": "2026-11-22", "value": 191788}]
}
Публичная сводка
Агрегированные показатели платформы доступны без авторизации:
GET /api/v1/public/overview.json
Коды ответов
| Код | Значение |
|---|---|
| 202 | события приняты в обработку |
| 401 | нужен действительный токен |
| 429 | превышен лимит запросов |