API GTA ON
Публичный API для виджетов, Telegram, ВК и ваших сервисов.
Проекты
GET /api/v1/projects
online — последний актуальный онлайн или null при устаревших данных. Ноль означает полученное значение 0. Идентификаторы проектов сохраняются между запросами.
measurement_at — время в UTC, когда часовой пояс источника известен. Иначе null, а исходная метка доступна в source_wall_time. received_at — Unix-время получения ответа, оно не доказывает свежесть замера. quality описывает состояние источника.
curl 'https://gtaon.ru/api/v1/projects'
Серверы и история
GET /api/v1/servers?project=ID GET /api/v1/history?project=ID&metric=online&start=2026-11-17&end=2026-11-17&timezone=Europe/Kaliningrad GET /api/v1/history?project=ID&server=SERVER_ID&metric=peak&start=2026-10-17&end=2026-11-17
ID берите из списка проектов и серверов. metric=online возвращает подробную историю за доступные последние семь дней. Для старых периодов используйте metric=peak — пики по дням. Пропуски не заполняются нулями. У наследованных данных без часового пояса дата остаётся датой источника.
Почасовой архив
GET /api/v1/hourly?project=ID&start=2026-11-01&end=2026-11-17&timezone=Europe/Kaliningrad
Необязательный server=ID ограничивает ответ сервером. Каждый час содержит минимум, максимум, sample_mean (среднее по наблюдениям), samples (число замеров), first_observed и last_observed (исходные метки времени). Пустые часы отсутствуют. Это не среднее с весом по времени и не доля доступности. Старые часы, для которых замеры уже удалены, не восстанавливаются из дневных пиков.
Пример на Python
import json
from urllib.request import urlopen
url = 'https://gtaon.ru/api/v1/projects'
with urlopen(url, timeout=15) as response:
data = json.load(response)
for project in data['projects']:
print(project['name'], project['online'])Не чаще одного запроса в минуту для обычного виджета. Технический лимит: 120 запросов в минуту с одного IP. Ошибки возвращаются JSON с полем error. API не требует токена; личные данные доступны только в кабинете.