Servers

Server auflisten, erstellen, abrufen, aktualisieren und löschen.

GET/servers

Alle Server des Resellers mit Paginierung und Filtern abrufen.

Query-Parameter

Name	Type	Required	Description
`page`	number	No	Seitennummer (Standard: 1)
`limit`	number	No	Einträge pro Seite, max 100 (Standard: 50)
`sort`	string	No	Sortierung: createdAt, name, ramGb, status (Standard: createdAt)
`order`	string	No	Richtung: asc oder desc (Standard: asc)
`status`	string	No	Nach Status filtern
`game`	string	No	Nach Spiel filtern
`search`	string	No	Servername durchsuchen (contains)

curl "https://www.mado-hosting.com/api/v1/servers?page=1&limit=10&sort=name&order=asc" \
  -H "Authorization: Bearer rsk_your_key"

POST/servers

Neuen Server erstellen. Gibt 202 zurück (Server wird provisioniert).

Body-Parameter

Name	Type	Required	Description
`name`	string	Yes	Servername (max 100 Zeichen)
`ramGb`	number	Yes	RAM in GB (positiv, 0.5GB-Schritte)
`game`	string	No	Spiel-ID (Standard: minecraft-java)
`gameType`	string	No	Spielvariante (Standard: paper)
`gameVersion`	string	No	Spielversion (Standard: 1.21.4)
`planTier`	string	No	budget oder premium (Standard: premium)
`addons`	AddonSelection[]	No	Array von Addon-Auswahlen
`externalReference`	string	No	Externe Referenz-ID (max 255 Zeichen)

curl -X POST "https://www.mado-hosting.com/api/v1/servers" \
  -H "Authorization: Bearer rsk_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My Server",
    "ramGb": 4,
    "game": "minecraft-java",
    "gameType": "paper",
    "planTier": "premium",
    "addons": [{ "addon": "plugin-installer", "selected": true }]
  }'

Der Server wird asynchron provisioniert. Der Status kann kurz nach dem Erstellen noch PROVISIONING sein.

GET/servers/:id

Server-Details mit Limits, Addons und Versionsnummer abrufen.

curl "https://www.mado-hosting.com/api/v1/servers/srv_abc123" \
  -H "Authorization: Bearer rsk_your_key"

PATCH/servers/:id

Server aktualisieren (RAM, Disk, externe Referenz). Unterstützt Optimistic Locking mit If-Match.

Headers

Name	Type	Required	Description
`If-Match`	string	No	Versionsnummer für Optimistic Locking

Body-Parameter

Name	Type	Required	Description
`ramGb`	number	No	Neues RAM in GB (positiv)
`diskGb`	number	No	Neues Disk in GB (positiv)
`externalReference`	string	No	Externe Referenz (max 255 Zeichen)

curl -X PATCH "https://www.mado-hosting.com/api/v1/servers/srv_abc123" \
  -H "Authorization: Bearer rsk_your_key" \
  -H "Content-Type: application/json" \
  -H "If-Match: 1" \
  -d '{ "ramGb": 8 }'

DELETE/servers/:id

Server dauerhaft löschen. Entfernt Server von Panel, SFTP und DNS.

curl -X DELETE "https://www.mado-hosting.com/api/v1/servers/srv_abc123" \
  -H "Authorization: Bearer rsk_your_key"

Diese Aktion ist unwiderruflich. Alle Serverdaten, Backups und DNS-Einträge werden gelöscht.

Fehlercodes

HTTP	Code	Beschreibung
400	`VALIDATION_ERROR`	Ungültige Parameter
404	`SERVER_NOT_FOUND`	Server nicht gefunden
409	`CONFLICT`	Version-Mismatch (If-Match)
503	`SERVICE_UNAVAILABLE`	Keine verfügbaren Nodes/Ports