KUNDEN-API · V1 BETA
REST-API für
VPS & Dedicated Server
Verwalten Sie Ihre Server per Code: Stunden-VPS bestellen und löschen, Power-Aktionen und Neuinstallationen ausführen, eigene Images erstellen und bereitstellen sowie Rechnungen mit Guthaben bezahlen.
Die Kunden-API von X-ZoneServers (v1, öffentliche Beta) bietet 92 Operationen über HTTPS, eine OpenAPI-3.0-Spezifikation, API-Schlüssel mit Scopes und ein Standardlimit von 1.000 Anfragen pro Stunde und Schlüssel. Sie ist in jedem Konto ohne Aufpreis enthalten.
92 API-Operationen1.000 Anfragen pro Stunde und Schlüssel
Ihr erster Aufruf
Erstellen Sie im Kundenbereich unter Profile → API Keys einen Schlüssel und fragen Sie die API dann, wer Sie sind.
curl https://my.x-zoneservers.com/api/v1/ \
-H "Authorization: Bearer $XZ_API_KEY"
{ "success": true,
"data": {
"version": "1",
"key": { "scopes": ["read", "services"] },
"rate_limit": { "limit": 1000, "remaining": 999 }
} }01Funktionen
Was Sie automatisieren können
Die API deckt den gesamten Lebenszyklus eines Servers ab, von der Bestellung bis zur Rechnung, mit denselben Berechtigungen wie der Kundenbereich.
Bereitstellen & Löschen
Bestellen Sie einen VPS mit stündlicher oder monatlicher Abrechnung, übergeben Sie cloud-init user-data und SSH-Schlüssel für den ersten Start und löschen Sie ihn, sobald der Job erledigt ist. Die Stundenabrechnung endet in dem Moment, in dem der Server gelöscht ist.
Power-Steuerung, Neuinstallation & Statistiken
Starten, stoppen, rebooten und installieren Sie Ihre VPS neu, setzen Sie Root-Passwörter zurück und rufen Sie Nutzungs- und Traffic-Statistiken aus Ihren Monitoring-Skripten ab.
Eigene Images
Erstellen Sie aus einem VPS ein Image (bis zu 3 pro Konto) oder registrieren Sie Ihr eigenes qcow2- oder Raw-Image (per SHA-256 verifiziert) und stellen Sie daraus neue Server bereit.
Abrechnung & Nutzung
Rufen Sie Ihr Guthaben und die Stundenkosten des laufenden Monats ab, listen Sie Rechnungen und Proforma-Rechnungen auf und begleichen Sie diese mit Guthaben — nützlich für Kosten-Dashboards und Budgetwarnungen.
Add-ons & Upgrades
Kaufen Sie Add-ons für einen bestehenden Dienst, etwa zusätzliche IP-Adressen, oder stufen Sie ihn auf einen größeren Tarif hoch, ohne den Kundenbereich zu öffnen.
Projekte & Schlüssel mit Scopes
Gruppieren Sie Server in Projekten und erstellen Sie Schlüssel, die an ein einzelnes Projekt gebunden sind — so kann ein Staging-Schlüssel die Produktion nie sehen oder anfassen.
02So funktioniert's
Beispiel: Ein Stunden-VPS für einen einzelnen CI-Job
Eine saubere Build-Maschine erstellen, die Pipeline ausführen, sie löschen — und die Stunden bezahlen, in denen sie existiert hat.
Stündlich abgerechnete Dienste werden von Ihrem Kontoguthaben abgebucht, statt in Rechnung gestellt zu werden — halten Sie daher Guthaben auf dem Konto bereit. Senden Sie bei jeder Bestellung einen Idempotency-Key-Header mit: Eine Anfrage mit Zeitüberschreitung lässt sich dann wiederholen, ohne einen zweiten Server anzulegen.
1. Tarif wählen: Produkte mit ihren Stunden- und Monatspreisen auflisten.
curl https://my.x-zoneservers.com/api/v1/products \
-H "Authorization: Bearer $XZ_API_KEY"2. Mit Stundenabrechnung bestellen, mit einem Skript für den ersten Start und Ihrem SSH-Schlüssel.
curl -X POST https://my.x-zoneservers.com/api/v1/orders \
-H "Authorization: Bearer $XZ_API_KEY" \
-H "Idempotency-Key: ci-run-4812" \
-H "Content-Type: application/json" \
-d '{"productId": "<plan-id>", "billingCycle": "hourly",
"hostname": "ci-4812.example.com", "location": "<location>",
"configOptions": {"os_image_id": "<image-id>",
"ssh_keys": ["ssh-ed25519 AAAA... ci@runner"],
"user_data": "#!/bin/sh\n/opt/ci/run-pipeline.sh"}}'3. Wenn der Job fertig ist, den Server löschen. Die Abrechnung endet sofort.
curl -X DELETE https://my.x-zoneservers.com/api/v1/vps/<vps-id> \
-H "Authorization: Bearer $XZ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"immediate": true}'03API
Gebaut für Skripte und KI-Agenten
Wenn ein Programm und nicht ein Mensch die Knöpfe drückt, zählt vorhersehbares Verhalten mehr als die Zahl der Endpunkte.
Schlüssel mit Scopes
Jeder Schlüssel erhält nur die Scopes, die Sie vergeben — read, services, orders, billing, destructive — sowie optional eine IP-Allowlist und ein Ablaufdatum.
Veröffentlichte Rate-Limits
Standardmäßig 1.000 Anfragen pro Stunde und Schlüssel, ausgewiesen in X-RateLimit-Headern, mit kurzen Cooldowns pro Server bei Power- und Neuinstallationsaktionen.
Sichere Wiederholungen
Bestellungen akzeptieren einen Idempotency-Key, und jede Ablehnung liefert einen maschinenlesbaren Fehlercode — so kann die Automatisierung einen wiederholbaren Fehlschlag von einem echten unterscheiden.
Maschinenlesbare Dokumentation
Eine OpenAPI-3.0-Spezifikation für Client-Generatoren und ein Leitfaden in reinem Markdown, den Coding-Assistenten und KI-Agenten direkt lesen können.
04Weiterlesen
Sie verkaufen Server an Ihre eigenen Kunden?
Diese Kunden-API automatisiert Ihr eigenes Konto. Um unter Ihrer eigenen Marke weiterzuverkaufen, treten Sie dem Reseller-Programm bei und nutzen stattdessen die Reseller-API: Großhandelspreise mit Mengenstaffeln, HMAC-signierte Anfragen, Webhooks, kundengebundene Schlüssel und Konsolen-Links, die Ihre Kunden ohne eigenes Konto bei uns öffnen.
05Fragen
API-FAQ
Häufige Fragen zur Automatisierung von X-ZoneServers.
Hat X-ZoneServers eine API?
Ja. Die Kunden-API (v1) ist eine REST-API über HTTPS unter https://my.x-zoneservers.com/api/v1 mit 92 Operationen für VPS, Dedicated Server, Bestellungen, Add-ons, Upgrades, Rechnungen, SSH-Schlüssel und eigene Images. Sie befindet sich in der öffentlichen Beta: stabil genug, um darauf aufzubauen, aber Endpunkte und Antwortformate können sich noch ändern.
Ist der API-Zugang kostenlos?
Ja. Der API-Zugang ist in jedem Konto ohne Aufpreis enthalten; Sie zahlen nur für die Server und Add-ons, die Sie bestellen, zu denselben Preisen wie auf der Website und im Kundenbereich.
Kann ich Stunden-VPS über die API erstellen und löschen?
Ja. Geben Sie eine Bestellung mit stündlichem Abrechnungszyklus auf, optional mit cloud-init user-data und SSH-Schlüsseln, und löschen Sie den VPS, wenn Sie ihn nicht mehr benötigen. Stundenbasierte Dienste werden vom Kontoguthaben abgebucht, und ihre Abrechnung endet, sobald sie gelöscht sind.
Funktioniert die API mit Dedicated Servern?
Teilweise. Bei Dedicated Servern deckt die API Bestellung, Add-ons, Rechnungen und Servicedetails ab. Power-Steuerung, OS-Neuinstallationen und Passwort-Resets sind für Dedicated Server weder über die API noch über den Kundenbereich verfügbar.
Wie authentifiziere ich mich?
Erstellen Sie im Kundenbereich unter Profile → API Keys einen API-Schlüssel und senden Sie ihn als Bearer-Token. Die Scopes legen Sie beim Erstellen fest; optional können Sie den Schlüssel auf bestimmte IP-Adressen beschränken oder mit einem Ablaufdatum versehen. Schlüssel werden nur einmal angezeigt und können jederzeit im Kundenbereich widerrufen werden.
Gibt es eine OpenAPI- oder Swagger-Spezifikation?
Ja. Die vollständige OpenAPI-3.0-Spezifikation ist unter https://my.x-zoneservers.com/api/v1/openapi.json veröffentlicht, neben der gerenderten Dokumentation und einem Nutzungsleitfaden in Markdown.
Loslegen
Erstellen Sie Ihren ersten API-Schlüssel
Melden Sie sich im Kundenbereich an, öffnen Sie Profile → API Keys und setzen Sie in weniger als einer Minute Ihren ersten Aufruf ab. API-Fragen gehen direkt an die Menschen, die die Plattform entwickeln.