Kundenbereich-API

Die API für dein Konto und deine Produkte.

Hier stehen ausschließlich Routen, die angemeldete Kunden für ihre eigenen Dienste nutzen können. Interne, Admin- und Staff-Schnittstellen sind nicht Teil dieser Referenz.

47 Endpunkte6 Bereiche OpenAPI JSON

Authentifizierung

Erstelle im Kundenbereich unter Einstellungen → API-Keys einen Schlüssel und schicke ihn als Bearer-Token mit. Der Schlüssel wird beim Anlegen genau einmal angezeigt - danach nur noch der Anfang. Kein Login, keine Sitzung, kein CSRF-Header.

1. Key anlegen und die benötigten Scopes auswählen (Rechte lassen sich später nur durch einen neuen Key ändern).
2. Bei jedem Aufruf mitschicken: Authorization: Bearer cts_live_...
3. Der Key gilt nur für dein eigenes Konto und lässt sich jederzeit widerrufen.

Scope	Erlaubt
servers:read	Server, Storage, Game Server, Domains und S3 lesen
servers:write	Server und Domains ändern (Power, Dateien, DNS, Backups)
billing:read	Rechnungen, Guthaben und Zahlungsarten lesen
support:write	Support-Tickets lesen und erstellen

Lese-Endpunkte brauchen den Lese-, schreibende den Schreib-Scope. Fehlt der Scope, antwortet die API mit 403 und nennt ihn. Die Kontoverwaltung (/auth/*: Keys, Passwort, Sitzungen) bleibt bewusst der Browser-Sitzung vorbehalten und ist mit einem API-Key gesperrt.

cURL

curl "https://api-v1.cts-hosting.com/api/kvm/servers" \
  -H "Authorization: Bearer cts_live_DEIN_API_KEY"

47 von 47 Endpunkten

Konto & Sicherheit

Daten und Sicherheitsfunktionen des angemeldeten Kundenkontos.

GET/auth/me Nur Sitzung

Eigenes Profil

Profil des angemeldeten Kunden abrufen.

GET/auth/sessions Nur Sitzung

Aktive Sitzungen

Angemeldete Geräte und Sitzungen auflisten.

DELETE/auth/sessions/{sessionId} Nur Sitzung

Sitzung widerrufen

Eine eigene Sitzung abmelden.

GET/auth/api-keys Nur Sitzung

API-Keys auflisten

Eigene API-Keys und Berechtigungen anzeigen.

POST/auth/api-keys Nur Sitzung

API-Key erstellen

Einen API-Key für das eigene Konto anlegen.

DELETE/auth/api-keys/{apiKeyId} Nur Sitzung

API-Key löschen

Einen eigenen API-Key unwiderruflich entfernen.

GET/customer/panel-overview

Kundenübersicht

Produkte, Guthaben, Benachrichtigungen und offene Vorgänge abrufen.

KVM Cloud

Nur die virtuellen Server des angemeldeten Kunden verwalten.

GET/kvm/serversservers:read

Server auflisten

Eigene KVM-Server abrufen.

GET/kvm/servers/{serverId}servers:read

Server-Details

Details eines eigenen KVM-Servers abrufen.

PATCH/kvm/servers/{serverId}servers:write

Server bearbeiten

Name oder kundenbezogene Einstellungen ändern.

POST/kvm/servers/{serverId}/powerservers:write

Power-Aktion

Server starten, stoppen oder neu starten.

GET/kvm/servers/{serverId}/historyservers:read

Verlauf abrufen

Metriken und Ereignisse des eigenen Servers abrufen.

GET/kvm/servers/{serverId}/backupsservers:read

Backups auflisten

Sicherungen eines eigenen Servers auflisten.

POST/kvm/servers/{serverId}/backupsservers:write

Backup erstellen

Eine neue Sicherung erstellen.

GET/kvm/servers/{serverId}/firewall/rulesservers:read

Firewall-Regeln

Eigene Firewall-Regeln abrufen.

POST/kvm/servers/{serverId}/firewall/rulesservers:write

Firewall-Regel erstellen

Eine Regel für den eigenen Server anlegen.

Storage & Object Storage

Eigene Storage-Server, Freigaben und S3-Buckets verwalten.

GET/storage/serversservers:read

Storage-Server auflisten

Eigene Storage-Server abrufen.

GET/storage/servers/{serverId}servers:read

Storage-Details

Details eines eigenen Storage-Servers abrufen.

POST/storage/servers/{serverId}/powerservers:write

Storage Power-Aktion

Eigenen Storage-Server starten oder stoppen.

PATCH/storage/servers/{serverId}/ftpservers:write

FTP-Einstellungen

FTP für den eigenen Server konfigurieren.

GET/s3/bucketsservers:read

S3-Buckets auflisten

Buckets des angemeldeten Kunden abrufen.

POST/s3/bucketsservers:write

S3-Bucket erstellen

Einen Bucket im eigenen Storage anlegen.

GET/s3/buckets/{bucketId}/access-keysservers:read

S3-Zugangsdaten

Access Keys eines eigenen Buckets auflisten.

POST/s3/buckets/{bucketId}/access-keysservers:write

S3 Access Key erstellen

Zugangsdaten für einen eigenen Bucket erstellen.

Game Server

Eigene Game Server, Dateien, Backups und Teamzugänge steuern.

GET/game-serversservers:read

Game Server auflisten

Eigene Game Server abrufen.

GET/game-servers/{serverId}servers:read

Game Server-Details

Details eines eigenen Game Servers abrufen.

POST/game-servers/{serverId}/powerservers:write

Power-Aktion

Den eigenen Game Server starten, stoppen oder neu starten.

GET/game-servers/{serverId}/consoleservers:read

Konsole abrufen

Ausgabe der eigenen Serverkonsole lesen.

POST/game-servers/{serverId}/console/commandservers:write

Konsolenbefehl

Einen Befehl an den eigenen Game Server senden.

GET/game-servers/{serverId}/filesservers:read

Dateien auflisten

Dateien des eigenen Game Servers auflisten.

PUT/game-servers/{serverId}/filesservers:write

Datei speichern

Eine Datei auf dem eigenen Game Server speichern.

GET/game-servers/{serverId}/backupsservers:read

Backups auflisten

Eigene Game-Server-Backups abrufen.

POST/game-servers/{serverId}/backupsservers:write

Backup erstellen

Ein Backup des eigenen Game Servers erstellen.

Domains & DNS

Nur Domains und DNS-Zonen, die dem angemeldeten Kunden gehören.

GET/domainsservers:read

Domains auflisten

Eigene Domains abrufen.

GET/domains/{id}servers:read

Domain-Details

Details einer eigenen Domain abrufen.

GET/domains/{id}/dnsservers:read

DNS-Einträge

DNS-Einträge einer eigenen Domain auflisten.

POST/domains/{id}/dnsservers:write

DNS-Eintrag erstellen

Einen DNS-Eintrag für eine eigene Domain erstellen.

PATCH/domains/{id}/dns/{recordId}servers:write

DNS-Eintrag ändern

Einen DNS-Eintrag der eigenen Domain ändern.

DELETE/domains/{id}/dns/{recordId}servers:write

DNS-Eintrag löschen

Einen DNS-Eintrag der eigenen Domain löschen.

Abrechnung

Rechnungen, Guthaben und Zahlungsdaten des eigenen Kundenkontos.

GET/billing/invoicesbilling:read

Rechnungen auflisten

Rechnungen des eigenen Kundenkontos abrufen.

GET/billing/invoices/{id}/pdfbilling:read

Rechnung als PDF

Eine eigene Rechnung herunterladen.

GET/billing/creditsbilling:read

Guthaben abrufen

Aktuelles Kontoguthaben abrufen.

POST/billing/credits/topupbilling:read

Guthaben aufladen

Eine Guthabenaufladung starten.

GET/billing/payment-methodsbilling:read

Zahlungsarten

Eigene Zahlungsarten auflisten.

DELETE/billing/payment-methods/{pmId}billing:read

Zahlungsart entfernen

Eine eigene Zahlungsart entfernen.

GET/billing/tax-profilebilling:read

Steuerprofil

Eigenes Steuerprofil abrufen.

PUT/billing/tax-profilebilling:read

Steuerprofil speichern

Eigenes Steuerprofil ändern.