Server Liste
Gibt eine Liste aller im Control Panel konfigurierten Server zurück, ohne sie zu pingen.
GET
/v1/servers
ping
Authentifizierung
Berechtigung ping oder * erforderlich.
Parameter
Keine Parameter.
Beispiel-Request
curl -H "X-API-Key: apk_dein_key" \
https://api.ferrixx.de/v1/servers
Antwort-Felder
| Feld | Typ | Beschreibung |
|---|
count | integer | Anzahl der Server in der Liste |
servers[].id | integer | Eindeutige Server-ID (für /v1/ping?id=) |
servers[].name | string | Anzeigename des Servers |
servers[].host | string | Hostname oder IP-Adresse |
servers[].port | integer | Port-Nummer |
servers[].type | string | Ping-Typ: tcp, icmp, http, https |
servers[].active | boolean | Ob der Server aktiv ist |
Beispiel-Antwort
{
"success": true,
"message": "OK",
"data": {
"count": 2,
"servers": [
{
"id": 1,
"name": "Google DNS",
"host": "8.8.8.8",
"port": 53,
"type": "tcp",
"active": true
},
{
"id": 2,
"name": "Webserver",
"host": "example.com",
"port": 443,
"type": "https",
"active": true
}
]
},
"timestamp": "2026-06-01T12:00:00+00:00"
}
Verwendung mit /ping
Die id aus dieser Liste kann direkt für GET /v1/ping?id= verwendet werden, um einen einzelnen Server zu pingen.
# Erst Server-Liste holen
curl -H "X-API-Key: apk_dein_key" https://api.ferrixx.de/v1/servers
# Dann Server #1 pingen
curl -H "X-API-Key: apk_dein_key" https://api.ferrixx.de/v1/ping?id=1