Minecraft Server Status
Fragt den Status eines Minecraft Java Edition Servers ab (Server List Ping Protokoll 1.7+).
GET
/v1/minecraft
minecraft
Authentifizierung
Berechtigung minecraft oder * erforderlich.
Parameter
| Parameter | Typ | Pflicht | Beschreibung |
|---|
host | string |
✱ Pflicht |
Hostname oder IP des Minecraft Servers |
port | integer |
optional |
Server-Port (Standard: 25565) |
Beispiel-Request
curl -H "X-API-Key: apk_dein_key" \
"https://api.ferrixx.de/v1/minecraft?host=play.example.com"
# Mit custom Port
curl -H "X-API-Key: apk_dein_key" \
"https://api.ferrixx.de/v1/minecraft?host=play.example.com&port=25565"
Beispiel-Antwort (Online)
{
"success": true,
"message": "OK",
"data": {
"status": "online",
"host": "play.example.com",
"port": 25565,
"latency_ms": 28,
"version": "Paper 1.20.4",
"protocol": 765,
"players": {
"online": 12,
"max": 100,
"sample": ["Notch", "jeb_"]
},
"description": "Ein toller Minecraft Server!",
"favicon": true
},
"timestamp": "2026-06-01T12:00:00+00:00"
}
Beispiel-Antwort (Offline)
{
"success": true,
"message": "OK",
"data": {
"status": "offline",
"host": "play.example.com",
"port": 25565,
"error": "Connection refused"
},
"timestamp": "2026-06-01T12:00:00+00:00"
}
Hinweise
- Kompatibel mit Minecraft Java Edition 1.7 und neuer
- Minecraft Bedrock Edition wird nicht unterstützt
- Timeout: 3 Sekunden – danach gilt der Server als offline
- Das Favicon-Feld gibt
true zurück, wenn ein Server-Icon vorhanden ist
- MOTD-Farbcodes (§) werden aus der Beschreibung entfernt