API интеграция статистики CheckStat

Сегодня мы запускаем счётчик CheckStat API. Это простой способ подключить статистику вашего сайта к собственным дашбордам, скриптам и отчётам.

Что можно делать с API:

• Забирать почасовые и дневные показатели (посетители, просмотры страниц, длительность сессий).
• Смотреть активность пользователей за последние 3 часа, 24 часа или 30 дней.
• Группировать результаты по стране, городу, браузеру, ОС, типу устройства, источнику и т. д.
• Получать 30-дневные агрегаты: топ стран, операционных систем и источников трафика.

Как это работает

1. Добавьте сайт в CheckStat и запишите его site_id.
2. Скопируйте персональный access key в профиле.
3. Отправляйте запросы с site_id и key.

Используйте необязательные параметры timezone и domain, чтобы показывать данные в вашем часовом поясе и при необходимости уточнять источники трафика.

Примеры

• Почасовая статистика за сегодня: GET https://checkstat.net/includes/api/get_today_widget.php?site_id=1&key=YOUR_KEY&timezone=Europe/Kiev
• Последние 30 дней, группировка по стране: GET https://checkstat.net/includes/api/get_visits.php?site_id=1&key=YOUR_KEY&group=country
• Активность пользователей за последние 24 часа: GET https://checkstat.net/includes/api/get_lastactivity.php?site_id=1&key=YOUR_KEY&period=1440

Зачем это нужно

С API вы можете:

• Смотреть статистику сайта прямо на своём сайте, не заходя в CheckStat.
• Автоматизировать отслеживание трафика и вовлечённости.
• Сравнивать источники, устройства и страны без открытия панели.

С чего начать

Откройте свой аккаунт, скопируйте ключ доступа и попробуйте примеры запросов выше. Если возникнут вопросы, напишите нашей команде – мы поможем.

Создавайте нужные отчёты быстро: стабильные эндпоинты, чистый JSON и поддержка часовых поясов.

Аутентификация и доступ

Используйте site_id и персональный key со страницы профиля. Держите ключ в секрете (не публикуйте его в клиентском коде). Все вызовы происходят по HTTPS.

Добавляйте timezone (например, Europe/Kiev), чтобы синхронизировать часы и дни с вашим локальным временем. Используйте domain, чтобы при необходимости точнее определять источники переходов.

Ошибки и ограничения

В каждом ответе есть поле success; при ошибках возвращается также error_message. Неверные параметры дают коды 4XX; проблемы на сервере — 5XX.

Слишком частые запросы могут быть ограничены по скорости. Кешируйте, где возможно, и уменьшайте частоту повторов. Нужна помощь? Напишите в поддержку и укажите эндпоинт и временной интервал (никогда не отправляйте свой ключ).