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.

Занадто часті виклики можуть обмежуватися за швидкістю. Кешуйте там, де це можливо, і зменшуйте частоту повторів. Потрібна допомога? Зверніться в підтримку та вкажіть ендпоїнт і часовий інтервал (ніколи не надсилайте свій ключ).