CS-TOP monitoring API

Monitoringning ochiq maʼlumotlari: Counter-Strike serverlari, xaritalar, onlayn. Kalit kerak emas, roʻyxatdan oʻtish ham — shunchaki soʻrov yuboring.

Manzil https://api.cs-top.uz

Format JSON, UTF-8, faqat GET

Cheklov 60 soʻrov / daqiqa

Javobda nima keladi

Barcha usullarda bitta qobiq. ok ni tekshiring — keyin oʻz sxemangiz bilan ishlang.

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

Serverlar

GET /v1/servers

Serverlar roʻyxati

Filtrlar va sahifalash bilan monitoring serverlari. Bloklanganlar hech qachon chiqmaydi.

Parametr	Turi	Tavsif	Misol
`game`	string	Oʻyin slugi: cs16, csgo, css, cs2	`cs16`
`q`	string	Nom, xarita va manzil boʻyicha qidiruv	`zombie`
`map`	string	Xaritaning aniq nomi	`de_dust2`
`mode`	string	Rejim slugi, /v1/modes ga qarang	`zombie`
`country`	string	Mamlakat kodi, ikki harf	`UZ`
`tasix`	bool	Faqat Tas-IX tarmogʻi	`1`
`online`	bool	Faqat javob berayotgan serverlar	`1`
`sort`	string	players, votes, name, added	`players`
`page`	int	Sahifa, birdan	`1`
`limit`	int	Sahifadagi yozuvlar, 1–100	`20`

https://api.cs-top.uz

GET /v1/servers/{address}

Server kartochkasi

ip:port koʻrinishidagi manzil boʻyicha bitta server. Qoʻshimcha ravishda rejimlar ham beriladi.

https://api.cs-top.uz

GET /v1/servers/{address}/players

Serverdagi oʻyinchilar

Hozir kim oʻynayapti: ism, hisob, oʻyindagi vaqt. Oxirgi soʻrov maʼlumotlari.

https://api.cs-top.uz

GET /v1/servers/{address}/pulse

Bir kunlik onlayn

Soatlab 24 nuqta: har soatdagi serverning oʻrtacha onlayni.

https://api.cs-top.uz

Xaritalar

GET /v1/maps

Ommabop xaritalar

Hozir nima oʻynalyapti: xarita, unda nechta server va odam bor.

Parametr	Turi	Tavsif	Misol
`game`	string	Oʻyin slugi	`cs16`
`tasix`	bool	Faqat Tas-IX	`1`
`limit`	int	Nechta xarita, 1–100	`25`

https://api.cs-top.uz

GET /v1/maps/{map}/servers

Xaritadagi serverlar

Bu xarita hozir qayerda ketyapti.

Parametr	Turi	Tavsif	Misol
`game`	string	Oʻyin slugi	`cs16`
`limit`	int	Yozuvlar, 1–100	`20`

https://api.cs-top.uz

Statistika

GET /v1/stats

Monitoring xulosasi

Hozir nechta server va oʻyinchi bor — jami va har bir oʻyin boʻyicha.

https://api.cs-top.uz

GET /v1/stats/pulse

Bir kunlik puls

Soʻnggi sutkada butun monitoring onlayni soatlab.

Parametr	Turi	Tavsif	Misol
`game`	string	Oʻyin slugi, aks holda barchasi	`cs16`

https://api.cs-top.uz

Maʼlumotnomalar

GET /v1/games

Oʻyinlar

Qolgan usullar kutadigan sluglar bilan oʻyinlar maʼlumotnomasi.

https://api.cs-top.uz

GET /v1/modes

Rejimlar

Oʻyin rejimlari va har birida nechta server bor.

Parametr	Turi	Tavsif	Misol
`game`	string	Faqat shu oʻyin boʻyicha hisoblash	`cs16`

https://api.cs-top.uz

GET /v1/countries

Mamlakatlar

Serverlar joylashgan mamlakatlar va ularning soni.

https://api.cs-top.uz

Cheklovlar

Manzil boʻyicha hisoblaymiz: daqiqasiga 60 soʻrov. Har bir javobda qoldiq haqida sarlavhalar bor.

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

Oshirib yuborsangiz — 429 va Retry-After sarlavhasi keladi. Javoblar 30–60 soniya keshlanadi: serverlar soʻrovi daqiqada bir marta, undan tez-tez yangi maʼlumot yoʻq.

Kalitlar keyinroq paydo boʻladi: baʼzi imkoniyatlar cs-top.uz kabinetidagi kalit orqali beriladi. Bu yerda tasvirlangan hamma narsa ochiq qoladi.

Xatolar

{
  "ok": false,
  "error": { "code": "not_found", "message": "…" }
}

HTTP	code	Qachon
400	`bad_request`	Parametr mos emas
404	`not_found`	Bunday usul yoki server yoʻq
405	`method_not_allowed`	GET emas
429	`rate_limited`	Cheklov oshirildi
500	`internal`	Bizning tomondagi xato