Справочник 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превышен лимит запросов