{"openapi":"3.0.3","info":{"title":"CS-TOP API","version":"v1","description":"Открытый API мониторинга cs-top.uz: серверы, карты, статистика."},"servers":[{"url":"https://api.cs-top.uz"}],"paths":{"/v1/servers":{"get":{"tags":["servers"],"summary":"Список серверов","description":"Серверы мониторинга с фильтрами и постраничным выводом. Забаненные не отдаются никогда.","parameters":[{"name":"game","in":"query","required":false,"description":"Слаг игры: cs16, csgo, css, cs2","example":"cs16","schema":{"type":"string"}},{"name":"q","in":"query","required":false,"description":"Поиск по названию, карте и адресу","example":"zombie","schema":{"type":"string"}},{"name":"map","in":"query","required":false,"description":"Точное имя карты","example":"de_dust2","schema":{"type":"string"}},{"name":"mode","in":"query","required":false,"description":"Слаг режима, см. /v1/modes","example":"zombie","schema":{"type":"string"}},{"name":"country","in":"query","required":false,"description":"Код страны, две буквы","example":"UZ","schema":{"type":"string"}},{"name":"tasix","in":"query","required":false,"description":"Только сеть Tas-IX","example":"1","schema":{"type":"boolean"}},{"name":"online","in":"query","required":false,"description":"Только отвечающие серверы","example":"1","schema":{"type":"boolean"}},{"name":"sort","in":"query","required":false,"description":"players, votes, name, added","example":"players","schema":{"type":"string"}},{"name":"page","in":"query","required":false,"description":"Страница, с единицы","example":"1","schema":{"type":"integer"}},{"name":"limit","in":"query","required":false,"description":"Записей на страницу, 1–100","example":"20","schema":{"type":"integer"}}],"responses":{"200":{"description":"OK"},"404":{"description":"Not found"},"429":{"description":"Rate limited"}}}},"/v1/servers/{address}":{"get":{"tags":["servers"],"summary":"Карточка сервера","description":"Один сервер по адресу вида ip:порт. Дополнительно отдаются режимы.","parameters":[{"name":"address","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"},"404":{"description":"Not found"},"429":{"description":"Rate limited"}}}},"/v1/servers/{address}/players":{"get":{"tags":["servers"],"summary":"Игроки на сервере","description":"Кто сейчас играет: имя, счёт, время в игре. Данные из последнего опроса.","parameters":[{"name":"address","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"},"404":{"description":"Not found"},"429":{"description":"Rate limited"}}}},"/v1/servers/{address}/pulse":{"get":{"tags":["servers"],"summary":"Онлайн за сутки","description":"24 точки по часам: средний онлайн сервера в каждый час.","parameters":[{"name":"address","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"},"404":{"description":"Not found"},"429":{"description":"Rate limited"}}}},"/v1/maps":{"get":{"tags":["maps"],"summary":"Популярные карты","description":"Во что играют прямо сейчас: карта, сколько серверов и людей на ней.","parameters":[{"name":"game","in":"query","required":false,"description":"Слаг игры","example":"cs16","schema":{"type":"string"}},{"name":"tasix","in":"query","required":false,"description":"Только Tas-IX","example":"1","schema":{"type":"boolean"}},{"name":"limit","in":"query","required":false,"description":"Сколько карт, 1–100","example":"25","schema":{"type":"integer"}}],"responses":{"200":{"description":"OK"},"404":{"description":"Not found"},"429":{"description":"Rate limited"}}}},"/v1/maps/{map}/servers":{"get":{"tags":["maps"],"summary":"Серверы на карте","description":"Где сейчас идёт эта карта.","parameters":[{"name":"map","in":"path","required":true,"schema":{"type":"string"}},{"name":"game","in":"query","required":false,"description":"Слаг игры","example":"cs16","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Записей, 1–100","example":"20","schema":{"type":"integer"}}],"responses":{"200":{"description":"OK"},"404":{"description":"Not found"},"429":{"description":"Rate limited"}}}},"/v1/stats":{"get":{"tags":["stats"],"summary":"Сводка мониторинга","description":"Сколько серверов и игроков сейчас — всего и по каждой игре.","parameters":[],"responses":{"200":{"description":"OK"},"404":{"description":"Not found"},"429":{"description":"Rate limited"}}}},"/v1/stats/pulse":{"get":{"tags":["stats"],"summary":"Пульс за сутки","description":"Онлайн всего мониторинга по часам за последние сутки.","parameters":[{"name":"game","in":"query","required":false,"description":"Слаг игры, иначе все","example":"cs16","schema":{"type":"string"}}],"responses":{"200":{"description":"OK"},"404":{"description":"Not found"},"429":{"description":"Rate limited"}}}},"/v1/games":{"get":{"tags":["reference"],"summary":"Игры","description":"Справочник игр со слагами, которые ждут остальные методы.","parameters":[],"responses":{"200":{"description":"OK"},"404":{"description":"Not found"},"429":{"description":"Rate limited"}}}},"/v1/modes":{"get":{"tags":["reference"],"summary":"Режимы","description":"Режимы игры и сколько серверов в каждом.","parameters":[{"name":"game","in":"query","required":false,"description":"Считать только по этой игре","example":"cs16","schema":{"type":"string"}}],"responses":{"200":{"description":"OK"},"404":{"description":"Not found"},"429":{"description":"Rate limited"}}}},"/v1/countries":{"get":{"tags":["reference"],"summary":"Страны","description":"Страны, где стоят серверы, и сколько их.","parameters":[],"responses":{"200":{"description":"OK"},"404":{"description":"Not found"},"429":{"description":"Rate limited"}}}}}}