CS-TOPAPI v1
Русский Oʻzbekcha
cs-top.uz

API мониторинга CS-TOP

Открытые данные мониторинга: серверы Counter-Strike, карты, онлайн. Ключ не нужен, регистрация не нужна — просто запрашивайте.

Адрес https://api.cs-top.uz
Формат JSON, UTF-8, только GET
Лимит 60 запросов в минуту

Что приходит в ответ

Оболочка одна у всех методов. Проверяйте ok — и дальше работайте со своей схемой.

{
  "ok": true,
  "data": [ … ],
  "meta": { "total": 385, "page": 1, "per_page": 20 }
}

Серверы

GET /v1/servers

Список серверов

Серверы мониторинга с фильтрами и постраничным выводом. Забаненные не отдаются никогда.

Параметр Тип Описание Пример
game string Слаг игры: cs16, csgo, css, cs2 cs16
q string Поиск по названию, карте и адресу zombie
map string Точное имя карты de_dust2
mode string Слаг режима, см. /v1/modes zombie
country string Код страны, две буквы UZ
tasix bool Только сеть Tas-IX 1
online bool Только отвечающие серверы 1
sort string players, votes, name, added players
page int Страница, с единицы 1
limit int Записей на страницу, 1–100 20
https://api.cs-top.uz
GET /v1/servers/{address}

Карточка сервера

Один сервер по адресу вида ip:порт. Дополнительно отдаются режимы.

https://api.cs-top.uz
GET /v1/servers/{address}/players

Игроки на сервере

Кто сейчас играет: имя, счёт, время в игре. Данные из последнего опроса.

https://api.cs-top.uz
GET /v1/servers/{address}/pulse

Онлайн за сутки

24 точки по часам: средний онлайн сервера в каждый час.

https://api.cs-top.uz

Карты

GET /v1/maps

Популярные карты

Во что играют прямо сейчас: карта, сколько серверов и людей на ней.

Параметр Тип Описание Пример
game string Слаг игры cs16
tasix bool Только Tas-IX 1
limit int Сколько карт, 1–100 25
https://api.cs-top.uz
GET /v1/maps/{map}/servers

Серверы на карте

Где сейчас идёт эта карта.

Параметр Тип Описание Пример
game string Слаг игры cs16
limit int Записей, 1–100 20
https://api.cs-top.uz

Статистика

GET /v1/stats

Сводка мониторинга

Сколько серверов и игроков сейчас — всего и по каждой игре.

https://api.cs-top.uz
GET /v1/stats/pulse

Пульс за сутки

Онлайн всего мониторинга по часам за последние сутки.

Параметр Тип Описание Пример
game string Слаг игры, иначе все cs16
https://api.cs-top.uz

Справочники

GET /v1/games

Игры

Справочник игр со слагами, которые ждут остальные методы.

https://api.cs-top.uz
GET /v1/modes

Режимы

Режимы игры и сколько серверов в каждом.

Параметр Тип Описание Пример
game string Считать только по этой игре cs16
https://api.cs-top.uz
GET /v1/countries

Страны

Страны, где стоят серверы, и сколько их.

https://api.cs-top.uz

Ограничения

Считаем по адресу: 60 запросов в минуту. В каждом ответе есть заголовки с остатком.

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 57
X-RateLimit-Reset: 1790454300

Превысили — придёт 429 и заголовок Retry-After. Ответы кэшируются на 30–60 секунд: опрос серверов идёт раз в минуту, чаще свежих данных всё равно нет.

Ключи появятся позже: часть возможностей будет выдаваться по ключу из кабинета на cs-top.uz. Всё, что описано здесь, останется открытым.

Ошибки

{
  "ok": false,
  "error": { "code": "not_found", "message": "…" }
}
HTTPcodeКогда
400bad_requestПараметр не подходит
404not_foundНет такого метода или сервера
405method_not_allowedНе GET
429rate_limitedПревышен лимит
500internalОшибка на нашей стороне