API Dokümantasyonu
MCAPI.TR, Minecraft sunucularını izlemek için basit ve verimli endpoint'ler sağlar. Başlamak için bilmeniz gereken her şey burada.
GET
/api/v1/status/:address
Herhangi bir Minecraft sunucusu hakkında kapsamlı bilgi sağlayan ana endpoint.
Örnek İstekler
GET /api/v1/status/hypixel.netGET /api/v1/status/mc.hypixel.net:25565GET /api/v1/status/play.cubecraft.net?legacy=trueGET /api/v1/status/hivebedrock.network?bedrock=trueParametreler
| Parametre | Tip | Herhangi bir Minecraft sunucusu hakkında kapsamlı bilgi sağlayan ana endpoint. |
|---|---|---|
address | string | Sunucu IP adresi (örn: hypixel.net) |
legacy | boolean | Eski sürüm desteği için true yapın |
bedrock | boolean | Bedrock sunucular için true yapın |
Örnek Yanıt
JSON
{
"query": {
"host": "cubecraft.net",
"port": 25565,
"legacy": false,
"bedrock": false
},
"server_id": "af2d95c3-0200-455d-90b2-1e8d8ba63965",
"ip_address": "193.105.184.230",
"icmp": true,
"online": true,
"error": null,
"version": {
"name": "§f§f§fWe support: 1.20-1.21",
"protocol": 340
},
"players": {
"online": 1592,
"max": 5000,
"sample": [
{
"name": "§4§k||§9§lCubeCraft§4§k||",
"id": "00000000-0000-0000-0000-000000000000"
},
{
"name": "§6Forums §f> cubecraft.net",
"id": "00000000-0000-0000-0000-000000000000"
},
{
"name": "§6Rules §f> cubecraft.net/rules",
"id": "00000000-0000-0000-0000-000000000000"
},
{
"name": "§6Discord §f> discord.gg/cubecraft",
"id": "00000000-0000-0000-0000-000000000000"
},
{
"name": "§6Store §f> store.cubecraft.net",
"id": "00000000-0000-0000-0000-000000000000"
},
{
"name": "§6Twitter §f> twitter.com/CubeCraftGames",
"id": "00000000-0000-0000-0000-000000000000"
}
]
},
"motd": {
"raw": "§f §f◀ §9§lCubeCraft Games§9 [EU] §f▶§f
§f §6§lSUMMER EVENT §7§l+ §b§lSKYBLOCK UPDATE!",
"clean": " ◀ CubeCraft Games [EU] ▶
SUMMER EVENT + SKYBLOCK UPDATE!",
"html": "<span><span style="color: #FFFFFF;"> </span><span style="color: #FFFFFF;">◀ </span><span style="color: #5555FF; font-weight: bold;">CubeCraft Games</span><span style="color: #5555FF;"> [EU] </span><span style="color: #FFFFFF;">▶</span><span style="color: #FFFFFF;">
</span><span style="color: #FFFFFF;"> </span><span style="color: #FFAA00; font-weight: bold;">SUMMER EVENT </span><span style="color: #AAAAAA; font-weight: bold;">+ </span><span style="color: #55FFFF; font-weight: bold;">SKYBLOCK UPDATE!</span></span>",
"raw_lines": [
"§f §f◀ §9§lCubeCraft Games§9 [EU] §f▶§f",
"§f §6§lSUMMER EVENT §7§l+ §b§lSKYBLOCK UPDATE!"
],
"clean_lines": [
" ◀ CubeCraft Games [EU] ▶",
" SUMMER EVENT + SKYBLOCK UPDATE!"
],
"html_lines": [
"<span><span style="color: #FFFFFF;"> </span><span style="color: #FFFFFF;">◀ </span><span style="color: #5555FF; font-weight: bold;">CubeCraft Games</span><span style="color: #5555FF;"> [EU] </span><span style="color: #FFFFFF;">▶</span><span style="color: #FFFFFF;">
</span><span style="color: #FFFFFF;"> </span><span style="color: #FFAA00; font-weight: bold;">SUMMER EVENT </span><span style="color: #AAAAAA; font-weight: bold;">+ </span><span style="color: #55FFFF; font-weight: bold;">SKYBLOCK UPDATE!</span></span>"
]
},
"favicon": "data:image/png;base64,...",
"srvRecord": {
"host": "play.cubecraft.net",
"port": 25565
},
"roundTripLatency": 18
}GET
/api/icon/dynamic
Sunucunun favicon'ını PNG formatında döndürür. Sunucu belirtilmezse varsayılan Minecraft sunucu ikonunu döndürür.
Örnek İstekler
GET /api/icon/dynamic?address=hypixel.netAçıklama
Content-Type başlığı image/png olarak döner. Sonuç direkt olarak bir görsel (64x64 PNG) dosyasıdır, eğer sunucu ikona sahip değilse varsayılan bir ikon gönderilir.