Server Status API

Minecraft sunucu durumunu JSON olarak döndüren public endpoint.

Ana sayfadaki "X oyuncu çevrimiçi" widget'ı ve mobil uygulamalar bu endpoint'ten veri çeker.

İstek

HTTP

GET /api/server-status.php

Parametre almaz. CORS açıktır (Access-Control-Allow-Origin: *), istediğin domainden çağırabilirsin.

Yanıt

JSON

{
    "online": true,
    "players": 47,
    "max_players": 100,
    "version": "1.20.4",
    "motd": "KAREBLOK — Türkiye'nin en eğlenceli sunucusu",
    "latency": 23,
    "cached": true,
    "timestamp": 1713811200
}

Cache

Endpoint 60 saniye boyunca sonuçları cache/server_status.json dosyasına yazar. Aynı saniyede 100 istek gelse bile Minecraft sunucusuna sadece 1 ping atılır.

Hata Durumu

Minecraft sunucusuna erişilemezse endpoint online: false döndürür — HTTP 200 kalır. Asıl sunucu hatalarında (PHP exception) 500 döner.

Birden fazla sunucun varsa ?server=slug parametresi ile belirli bir sunucunun durumunu sorgulayabilirsin (varsayılan: ilk sunucu).

← Önceki SSS Yönetimi Sonraki → Payment Callback API