GTAON

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 не требует токена; личные данные доступны только в кабинете.