Zurückelizon

API-Referenz

Integriere die elizon-Plattform über unsere REST-API. Alle authentifizierten Endpunkte erfordern einen x-api-key-Header.

Endpunkte

191

Kategorien

28

Auth

x-api-key

Basis-URL

/api

OpenAPI-Spezifikation herunterladen (JSON)

Maschinell lesbare Übersicht der öffentlichen Routen

Schnellstart

Erstelle einen API-Schlüssel unter Dashboard → API-Schlüssel und sende ihn im x-api-key-Header mit.

# Eigene Services auflisten

curl /api/services \

-H "x-api-key: YOUR_API_KEY"


# Ein Support-Ticket erstellen

curl -X POST /api/tickets \

-H "x-api-key: YOUR_API_KEY" \

-H "Content-Type: application/json" \

-d '{"subject": "Help", "message": "..."}'

So funktioniert’s

Die elizon-API folgt RESTful-Konventionen. Alle Anfragen und Antworten verwenden JSON (Content-Type: application/json). Die Basis-URL für jeden Endpunkt lautet:

/api

Antwortformat

Jede Antwort enthält ein success-Feld auf oberster Ebene. Bei Erfolg liegen die Nutzdaten direkt daneben – es gibt kein Wrapper-Objekt. Der Entitätsname variiert je nach Endpunkt (user, tickets, invoices usw.).

Erfolg

{
  "success": true,
  "services": [
    { "id": "abc123", "name": "My Server", "status": "RUNNING" }
  ],
  "pagination": {
    "page": 1,
    "limit": 10,
    "total": 42,
    "pages": 5
  }
}

Fehler

{
  "success": false,
  "error": "Authentication required"
}

Validierungsfehler

{
  "success": false,
  "error": "Validation failed for egg variables",
  "validationErrors": [
    "Variable 'SERVER_PORT' is required",
    "Variable 'MAX_PLAYERS' must be a number"
  ]
}

Authentifizierung

Die meisten Endpunkte erfordern einen gültigen API-Schlüssel. Sende ihn bei jeder Anfrage als benutzerdefinierten Header:

x-api-key: YOUR_API_KEY

Schlüssel sind bereichsbezogen – beim Erstellen wählst du die gewünschten Berechtigungen. Endpunkte mit „Kein API-Key“ sind nur mit einer Session nutzbar (Login, Registrierung usw.) und können nicht mit einem Key angesprochen werden.

Rate-Limiting

Anfragen sind pro Schlüssel begrenzt. Bei Überschreitung erhältst du eine 429-Antwort mit einem retryAfter-Feld und Rate-Limit-Headern.

{
  "success": false,
  "error": "Rate limit exceeded",
  "retryAfter": 60
}

Headers:
  X-RateLimit-Limit: 100
  X-RateLimit-Remaining: 0
  X-RateLimit-Reset: 1677654321000
  Retry-After: 60

Fehlerbehandlung

Alle Fehlerantworten liefern success: false und einen error-String. Manche Endpunkte fügen zusätzlich validationErrors (ein Array von Strings) oder einen errorKey zur programmatischen Verarbeitung hinzu.

Häufige Statuscodes

  • 200 OK – Erfolgreich
  • 201 Created – Ressource erstellt
  • 400 Bad Request – Validierungsfehler oder fehlerhafter Body
  • 401 Unauthorized – Fehlender oder ungültiger API-Schlüssel
  • 403 Forbidden – Schlüssel hat nicht die nötige Berechtigung
  • 404 Not Found – Ressource existiert nicht
  • 429 Too Many Requests – Rate-Limit erreicht
  • 500 Internal Server Error – Serverfehler auf unserer Seite

Paginierung

Listen-Endpunkte unterstützen die Query-Parameter page und limit. Die Antwort enthält ein pagination-Objekt zur Berechnung der Seitenanzahl. Einige Endpunkte verwenden Offset-basierte Paginierung mit offset und hasMore.

GET /api/tickets?page=2&limit=10

{
  "success": true,
  "tickets": [...],
  "pagination": {
    "page": 2,
    "limit": 10,
    "total": 42,
    "pages": 5
  }
}

Offset-basiert

GET /api/invoices?offset=10&limit=10

{
  "success": true,
  "invoices": [...],
  "pagination": {
    "total": 42,
    "limit": 10,
    "offset": 10,
    "hasMore": true
  }
}

Öffentlich

Öffentliche Endpunkte und Systeminformationen ohne Anmeldung.

GET
/api/pingÖffentlich

Misst die Latenz zur API und liefert { ok: true, location }. Optional mit ?location= für mehrere Standorte.

GET
/api/public/navigationÖffentlich

Liefert die Navigationsstruktur für die Oberfläche. Unterstützt ?lang= für Lokalisierung.

GET
/api/public/reviewsÖffentlich

Liefert moderierte Kundenbewertungen (ab 4 Sterne) für die Startseite, höchstens 20 Einträge.

GET
/api/public/registration-statusÖffentlich

Prüft, ob Registrierungen erlaubt sind (allgemein, privat, Business). Wird von der Registrierungsseite genutzt.

GET
/api/public/countriesÖffentlich

Liefert alle Länder inklusive Steuersätze für Formulare bei Registrierung und Checkout.

GET
/api/public/providers/{id}/catalogÖffentlich

Liefert Vorlagen und Knoten eines Anbieters ohne sensible Daten für Produkt- und Bestellabläufe.

GET
/api/knowledge-baseÖffentlich

Listet veröffentlichte Wissensdatenbank-Artikel. Unterstützt ?lang= für lokaliserte Inhalte.

Authentifizierung

Anmeldung, Registrierung, Sitzungen und Verifizierungsabläufe.

POST
/api/auth/registerÖffentlich

Registriert ein neues Konto per E-Mail und Passwort (privat oder Business). Versendet Aktivierungscode per E-Mail und legt bei Erfolg eine Session an.

POST
/api/auth/loginÖffentlich

Meldet mit E-Mail und Passwort an. Unterstützt 2FA (TOTP, Backup-Codes, Passkeys). Rate-Limited. Setzt bei Erfolg das Session-Cookie.

POST
/api/auth/logoutAuth

Beendet die aktuelle Session und entfernt das Session-Cookie.

POST
/api/auth/verify-codeÖffentlich

Prüft den sechsstelligen E-Mail-Code und schließt die Anmeldung ab (E-Mail-2FA). Legt bei Erfolg eine Session an.

POST
/api/auth/verify-accountAuth

Schließt die Kontofreischaltung ab, indem der sechsstellige Aktivierungscode aus der E-Mail übermittelt wird.

POST
/api/auth/verify-account/resendAuth

Versendet den Aktivierungscode erneut per E-Mail (Cooldown 60 Sekunden zwischen Versänden).

POST
/api/auth/verify-emailÖffentlich

Bestätigt eine E-Mail-Adresse mit dem per E-Mail versandten Token.

GET
/api/auth/verify-emailAuth

Fordert für den angemeldeten Benutzer erneut einen Link zur E-Mail-Verifizierung an.

POST
/api/auth/forgot-passwordÖffentlich

Fordert einen Link zum Zurücksetzen des Passworts per E-Mail an (rate-limited).

POST
/api/auth/reset-passwordÖffentlich

Setzt das Passwort mit einem gültigen Reset-Token zurück.

GET
/api/auth/reset-passwordÖffentlich

Prüft, ob ein Passwort-Reset-Token noch gültig ist.

POST
/api/auth/change-passwordAuth

Ändert das Passwort des angemeldeten Benutzers. Erfordert das aktuelle Passwort und optional eine 2FA-Bestätigung.

GET
/api/auth/meAuth

Liefert das vollständige Profil des angemeldeten Benutzers inklusive Guthaben, Einstellungen und Kontodetails.

PUT
/api/auth/meAuth

Aktualisiert Profildaten (Anzeigename, Avatar, Sprache usw.).

GET
/api/auth/sessionAuth

Validiert die Session und liefert Basisinformationen zum Benutzer. Unterstützt parallele Sessions.

GET
/api/auth/sessionsAuth

Listet alle aktiven Sessions des Benutzers und kennzeichnet die aktuelle Session.

DELETE
/api/auth/sessionsAuth

Widerruft eine Session anhand der ID oder beendet alle anderen Sessions.

GET
/api/auth/2fa/setupAuth

Erzeugt TOTP-Geheimnis und QR-Code zum Aktivieren der Zwei-Faktor-Authentifizierung.

POST
/api/auth/2fa/setupAuth

Bestätigt die 2FA-Einrichtung mit einem gültigen TOTP-Code und erzeugt Backup-Codes.

GET
/api/auth/passkeysAuth

Listet alle registrierten Passkeys des angemeldeten Benutzers.

DELETE
/api/auth/passkeysAuth

Entfernt einen Passkey anhand seiner ID.

GET
/api/auth/passkeys/registerAuth

Liefert WebAuthn-Registrierungsoptionen zum Hinzufügen eines neuen Passkeys.

POST
/api/auth/passkeys/registerAuth

Schließt die Passkey-Registrierung mit der WebAuthn-Attestation-Antwort ab.

POST
/api/auth/passkeys/authenticateÖffentlich

Erzeugt die WebAuthn-Authentifizierungs-Challenge für den 2FA-Schritt beim Login.

GET
/api/auth/oauth/providersÖffentlich

Listet aktivierte OAuth-Anbieter für die Login-Seite (Name, Icon, Farbe).

GET
/api/auth/oauth/{provider}Öffentlich

Startet den OAuth-Flow beim gewählten Anbieter und leitet zur Autorisierungs-URL weiter.

GET
/api/auth/oauth/{provider}/callbackÖffentlich

Verarbeitet den OAuth-Callback: verknüpft oder erstellt das Konto und legt eine Session an.

GET
/api/auth/oauth/link/{provider}Auth

Startet die Verknüpfung eines OAuth-Anbieters mit einem bestehenden Konto.

DELETE
/api/auth/oauth/link/{provider}Auth

Entfernt die Verknüpfung eines OAuth-Anbieters vom aktuellen Konto.

Benutzereinstellungen

Persönliche Kontoeinstellungen und Präferenzen verwalten.

PATCH
/api/user/settingsAuth

Aktualisiert Benachrichtigungs- und E-Mail-Einstellungen (z. B. Login-Hinweis, E-Mail-Benachrichtigungen).

POST
/api/user/change-emailAuth

Schritt 1 der E-Mail-Änderung: prüft Passwort und 2FA und sendet einen Sechsstellencode an die neue Adresse.

POST
/api/user/change-email/verify-newAuth

Schritt 2: bestätigt den Code auf der neuen E-Mail und sendet einen Bestätigungscode an die alte Adresse.

POST
/api/user/change-email/verify-oldAuth

Schritt 3: bestätigt den Code auf der alten E-Mail und schließt die Änderung ab.

GET
/api/user/newsletter-settingsAuth

Liefert den aktuellen Newsletter-Opt-in-Status des angemeldeten Benutzers.

POST
/api/user/newsletter-settingsAuth

Aktualisiert den Newsletter-Opt-in. Opt-in erfordert E-Mail-Verifizierung; Opt-out wirkt sofort.

GET
/api/user/support-pinAuth

Liefert den gültigen Support-PIN zur Identitätsprüfung gegenüber dem Support (nicht abgelaufen).

POST
/api/user/support-pinAuth

Erzeugt einen neuen sechsstelligen Support-PIN zur Identitätsprüfung gegenüber dem Support.

GET
/api/user/subscriptionsAuth

Liefert alle aktiven Abonnements des aktuellen Benutzers.

POST
/api/user/subscriptionsAuth

Legt ein neues Abonnement für den aktuellen Benutzer an.

GET
/api/user/gdpr-exportAuth

Erzeugt einen umfassenden DSGVO-Datenexport (PDF oder TXT) aller zum Benutzer gespeicherten Daten.

DELETE
/api/user/gdpr-exportAuth

Löscht das Benutzerkonto und alle zugehörigen Daten dauerhaft (Recht auf Löschung).

GET
/api/user/autopayÖffentlich

[VERALTET – 410 Gone] Kontoweites Autopay wurde durch autodebit pro Abonnement ersetzt.

PATCH
/api/user/autopayÖffentlich

[VERALTET – 410 Gone] Kontoweites Autopay wurde durch autodebit pro Abonnement ersetzt.

Adressen

Rechnungs- und Lieferadressen verwalten.

GET
/api/addressesAuth

Listet alle Rechnungsadressen des Benutzers, sortiert nach Standardadresse und Erstellungsdatum.

POST
/api/addressesAuth

Legt eine neue Rechnungsadresse an. Business-Konten benötigen einen Firmennamen. EU-USt-Id wird formal geprüft.

PUT
/api/addressesAuth

Aktualisiert eine bestehende Rechnungsadresse anhand ihrer ID.

DELETE
/api/addressesAuth

Löscht eine Rechnungsadresse anhand ihrer ID.

Rechnungs-E-Mail

Rechnungsbezogene E-Mail-Adresse verwalten und verifizieren.

POST
/api/billing-emailAuth

Setzt oder ändert die Rechnungs-E-Mail. Erfordert Passwort und 2FA; versendet einen Bestätigungscode an die neue Adresse.

DELETE
/api/billing-emailAuth

Entfernt die separate Rechnungs-E-Mail (Rechnungen gehen wieder an die Kontakt-E-Mail).

API-Schlüssel

API-Schlüssel für die Automatisierung erstellen und verwalten.

GET
/api/api-keysAuth

Listet alle API-Schlüssel des Benutzers (nur Präfix, nie der vollständige Schlüssel).

POST
/api/api-keysAuth

Erstellt einen neuen API-Schlüssel. Der vollständige Schlüssel wird nur einmal bei der Erstellung zurückgegeben.

DELETE
/api/api-keysAuth

Widerruft oder löscht einen API-Schlüssel anhand seiner ID.

Produkte

Verfügbare Produkte und Kategorien durchsuchen.

GET
/api/productsÖffentlich

Liefert aktive Produktkategorien inklusive Produkte. Unterstützt ?lang=. Business-Kunden sehen geschäftsspezifische Preise und Kategorien.

GET
/api/products/{category}Öffentlich

Liefert eine Produktkategorie mit Produkten und Unterkategorien.

GET
/api/products/{category}/{product}Öffentlich

Liefert Produktdetails anhand Kategorie-Schlüssel und Produkt-Slug inklusive Preisen, Optionen und Anbieterinfos.

GET
/api/products/by-slug/{slug}Öffentlich

Liefert ein Produkt anhand des Slugs (optional gefiltert nach Kategorie).

GET
/api/products/templatesÖffentlich

Liefert verfügbare OS-Vorlagen für ein Produkt aus der Cluster-Konfiguration (eingeschränkt durch erlaubte Template-IDs).

GET
/api/products/locationsÖffentlich

Liefert Standortoptionen (id, Name, Flagge, Stadt, pingUrl) pro Produkt für den Checkout.

GET
/api/categories/{id}/upgrade-configAuth

Liefert Upgrade-/Downgrade-Konfiguration einer Kategorie (Ressourcenpreise, erlaubte Bereiche, Zusatz-IP-Preise).

Warenkorb & Checkout

Warenkorb verwalten und Bestellungen abschließen.

POST
/api/cart/validateAuth

Prüft Warenkorbpositionen auf Verfügbarkeit beim Anbieter und liefert nicht verfügbare Positionen.

POST
/api/cart/calculateAuth

Berechnet Preise serverseitig inklusive anteiligem Upgrade, Steuern und Rabatten.

POST
/api/cart/upgradeAuth

Berechnet Upgrade-/Downgrade-Preise für einen Service und liefert eine Warenkorbposition mit anteiligem Preis.

Checkout

Bestellabschluss, Zahlungsinitialisierung und Kaufabschluss.

POST
/api/checkoutAuth

Führt den Checkout mit Warenkorbpositionen aus. Unterstützt u. a. Mollie, SEPA, Guthaben, Rechnung und BusinessFund; Gutschein-/Affiliate-Codes, NetPoints und Rechnungsadresse. Doppel-Submit wird clusterweit verhindert.

Gutscheine

Rabattcoupons validieren und einlösen.

POST
/api/coupons/previewAuth

Prüft einen Gutscheincode und zeigt den Rabattbetrag an. Pro Bestellung ist nur ein Gutschein möglich.

Guthaben & NetPoints

Kontoguthaben und Treuepunkte verwalten.

POST
/api/balance/top-upAuth

Erstellt einen Mollie-Zahlungslink zum Aufladen des Kontoguthabens (Min/Max konfigurierbar). Die Rechnung entsteht erst nach Webhook-Bestätigung.

GET
/api/balance/sepa-detailsAuth

Liefert SEPA-Bankdaten (IBAN, BIC) für manuelle Überweisung inklusive nutzerspezifischer Referenz.

NetPoints

NetPoints-Stand und zugehörige Transaktionen einsehen.

GET
/api/netpointsAuth

Liefert den aktuellen NetPoints-Stand und den EUR-Gegenwert.

POST
/api/netpoints/previewAuth

Berechnet die maximal einlösbaren NetPoints für einen gegebenen Bestellwert.

Rechnungen

Rechnungen auflisten, Details einsehen und Dokumente abrufen.

GET
/api/invoicesAuth

Listet Rechnungen des Benutzers. Admins können ?userId= nutzen. Filter nach Status und serviceId möglich.

POST
/api/invoicesAuth

Erstellt eine neue Rechnung (nur Admin-Session oder Admin-API-Key). Steuerberechnung aus Rechnungseinstellungen; optionales Fälligkeitsdatum.

GET
/api/invoices/{id}Auth

Liefert eine einzelne Rechnung. Nutzer nur eigene; Admins alle.

GET
/api/invoices/{id}/documentAuth

Lädt die Rechnung als PDF (Lexware mit lokalem Cache).

POST
/api/invoices/{id}/payAuth

Startet eine Zahlung für eine Rechnung (Mollie, SEPA, Guthaben). Bei Erfolg werden gesperrte Services wieder freigegeben.

GET
/api/invoices/download-allAuth

Lädt alle Lexware-Rechnungs-PDFs des Nutzers als ZIP-Archiv herunter.

Services

Service-Verwaltung inklusive Status, Aktionen und Laufzeitdaten.

GET
/api/servicesAuth

Listet Services des Benutzers mit Paginierung; Filter für eigene/geteilte, nur VMs, nur Proxmox; kompakte Darstellung für Dashboard und Auswahlfelder.

POST
/api/servicesAuth

Legt eine neue Service-Instanz an (typischerweise Checkout/Provisioning).

POST
/api/services/status-batchAuth

Holt Live-Status mehrerer berechtigter Services in einer Anfrage für Listen und Dashboards.

GET
/api/services/total-bandwidthAuth

Summiert den monatlichen Traffic über alle Services des Nutzers; optional ?month=YYYY-MM.

GET
/api/services/{id}Auth

Liefert Service-Details inklusive Ressourcen, IPs, Anbieter und Abonnement. Geteilter Zugriff über Berechtigungen.

PATCH
/api/services/{id}Auth

Aktualisiert Service-Eigenschaften (Notizen, Anzeigename).

DELETE
/api/services/{id}Auth

Plant die Löschung des Services.

POST
/api/services/{id}/actionAuth

Führt eine Service-Aktion aus (start, stop, restart, reset, suspend, resume) je nach Berechtigung.

GET
/api/services/{id}/statusAuth

Liefert Live-Status vom Anbieter (CPU, RAM, Disk, Netz, Power-State).

GET
/api/services/{id}/settingsAuth

Liefert VM-Anzeige (Standard/Serial) und Boot (UEFI/Legacy) über den Provider-Adapter.

PATCH
/api/services/{id}/settingsAuth

Aktualisiert VM-Anzeige und Boot-Einstellungen über den Provider-Adapter.

GET
/api/services/{id}/trafficAuth

Liefert Traffic-/RRD-Daten über den Provider-Adapter; ?timeframe=hour|day|week|month.

GET
/api/services/{id}/bandwidth-usageAuth

Aggregierte Bandbreitennutzung der aktuellen Abrechnungsperiode; optional ?from=&to=; Ergebnisse gecacht.

GET
/api/services/{id}/disk-usageAuth

Dateisystem-Belegung über QEMU Guest Agent (nur Proxmox).

GET
/api/services/{id}/billing-cyclesAuth

Liefert erlaubte Abrechnungszyklen für den Service gemäß Produktkonfiguration.

POST
/api/services/{id}/upgradeAuth

Upgrade/Ressourcenänderung (CPU, RAM, Disk) über den Provider-Adapter.

POST
/api/services/{id}/apply-downgradeAuth

Wendet ein Downgrade sofort an: Ressourcen anpassen, Laufzeit verlängern, Service neu starten.

POST
/api/services/{id}/reinstallAuth

Installiert Betriebssystem/Vorlage neu (templateId, OS, Docker-Image, Egg-Auswahl).

GET
/api/services/{id}/templatesAuth

Liefert verfügbare Neuinstallations-Vorlagen über den Provider-Adapter.

POST
/api/services/{id}/renewAuth

Berechnet den Verlängerungspreis für einen gewählten Zyklus ohne Rechnung zu erstellen.

GET
/api/services/{id}/notificationsAuth

Liefert aktive Anbieter-Hinweise oder Massen-Mail-Alerts für den Service.

GET
/api/services/{id}/eggsAuth

Liefert erlaubte Eggs aus Kategorie und Provider-Variablen (Pterodactyl).

GET
/api/services/{id}/startup-variablesAuth

Listet Umgebungs- und Startvariablen des Pterodactyl-Servers.

PATCH
/api/services/{id}/startup-variablesAuth

Aktualisiert die Startvariablen des Pterodactyl-Servers.

GET
/api/services/{id}/allocationsAuth

Listet alle Port-Zuweisungen eines Pterodactyl-Servers.

Service Firewall

Firewall-Regeln und Netzwerkzugriffe für Services verwalten.

GET
/api/services/{id}/firewallAuth

Listet Firewall-Regeln des Services über den Provider-Adapter.

POST
/api/services/{id}/firewallAuth

Legt eine neue Firewall-Regel an.

PATCH
/api/services/{id}/firewall/{ruleId}Auth

Aktualisiert eine Firewall-Regel (nur erlaubte Felder).

DELETE
/api/services/{id}/firewall/{ruleId}Auth

Löscht eine Firewall-Regel.

Service Backups

Backups erstellen, auflisten, wiederherstellen und löschen.

GET
/api/services/{id}/backupsAuth

Listet Backups des Services über den Provider-Adapter.

POST
/api/services/{id}/backupsAuth

Erstellt ein neues Backup über den Provider-Adapter.

POST
/api/services/{id}/backups/{backupId}Auth

Stellt ein bestimmtes Backup über den Provider-Adapter wieder her.

DELETE
/api/services/{id}/backups/{backupId}Auth

Löscht ein bestimmtes Backup über den Provider-Adapter.

GET
/api/services/{id}/backups/{backupId}/downloadAuth

Liefert eine Download-URL für ein Backup (nur Pterodactyl).

Service Konsole

Konsolenzugriff und Live-Interaktionen für Services.

GET
/api/services/{id}/consoleAuth

Liefert Konsoleninformationen: VNC-Token/URL für Proxmox, SSE für Pterodactyl. Rohe wss://-URLs verlassen den Server nicht.

GET
/api/services/{id}/console/embedAuth

Liefert eine HTML-Seite mit VNC-Iframe für Proxmox; setzt PVEAuthCookie serverseitig.

GET
/api/services/{id}/console/streamAuth

SSE-Stream für Pterodactyl-Konsolenausgabe, Status und Statistiken über einen serverseitigen WebSocket-Proxy.

POST
/api/services/{id}/console/commandAuth

Sendet einen Konsolenbefehl oder Power-Aktion über den WebSocket zum Pterodactyl-Daemon.

Service Dateien

Dateiverwaltung innerhalb von Services.

GET
/api/services/{id}/filesAuth

Listet, liest, schreibt, erstellt, löscht und benennt Dateien auf einem Pterodactyl-Server (Aktion per Query-Parameter).

Service Abonnement

Abonnements, Laufzeiten und Verlängerungen von Services.

GET
/api/services/{id}/subscriptionAuth

Liefert Abonnementdetails (Zyklus, Perioden, Kündigungsstatus, Verlängerungsoptionen).

POST
/api/services/{id}/subscription/cancelAuth

Kündigt das Abonnement sofort oder zum Periodenende. Sofortkündigung beendet den Service beim Anbieter.

POST
/api/services/{id}/subscription/reactivateAuth

Macht eine ausstehende Periodenende-Kündigung rückgängig.

POST
/api/services/{id}/subscription/extendAuth

Verlängert die Laufzeit; optional 7-Tage-Bonus (einmal pro Service) und Loyalitätsangebot (10 % dauerhaft + 7 Tage).

PATCH
/api/services/{id}/subscription/intervalAuth

Setzt den nächsten Abrechnungszyklus (wirksam bei Verlängerung). Erlaubt: 7, 14, 30, 60, 90, 120, 365 Tage.

PATCH
/api/services/{id}/subscription/billing-addressAuth

Setzt die Rechnungsadresse für das Abonnement (in den Abonnement-Optionen gespeichert).

PATCH
/api/services/{id}/subscription/autopayAuth

Konfiguriert Autodebit fürs Abonnement (ein/aus, optional NetPoints zuerst).

POST
/api/services/{id}/ips/cancelAuth

Plant die Kündigung einer IP zum Periodenende oder hebt eine geplante Kündigung auf.

Speicher

Dateien hochladen und verwalten.

GET
/api/storageAuth

Listet Speichervolumes des Nutzers (eigenständige Services und ältere eingebettete Volumes).

POST
/api/storageAuth

Erstellt ein neues Speichervolume (Legacy-Flow).

GET
/api/storage/configAuth

Liefert verfügbare Speichertypen und Preise aus der Knotenkonfiguration; optional auf einen Server bezogen.

POST
/api/storage/add-to-cartAuth

Legt Zusatzspeicher mit Preisberechnung in den Warenkorb; Zuweisung zur VM erfolgt nach Zahlung.

GET
/api/storage/{id}Auth

Liefert Details eines Speichervolumes (eigenständig oder Legacy).

PATCH
/api/storage/{id}Auth

Aktualisiert Name und Zuordnung des Volumes.

DELETE
/api/storage/{id}Auth

Löscht ein Speichervolume.

POST
/api/storage/{id}/cancelAuth

Kündigt das Speicher-Abonnement (sofort oder zum Periodenende); trennt das Volume und startet die VM bei Bedarf neu.

Support-Tickets

Support-Tickets erstellen und verwalten.

GET
/api/ticketsAuth

Listet Support-Tickets mit Paginierung, Statusfilter und Antwortzeit-Kennzahlen.

POST
/api/ticketsAuth

Erstellt ein Ticket mit Betreff, Nachricht, Priorität und optionaler Service-Zuordnung.

GET
/api/tickets/{id}Auth

Liefert Ticket inklusive aller Nachrichten. Nutzer nur eigene Tickets außer Admin/Support.

POST
/api/tickets/{id}Auth

Fügt eine Nachricht oder Antwort zum Ticket hinzu.

PATCH
/api/tickets/{id}Auth

Aktualisiert den Ticketstatus (schließen, wieder öffnen usw.).

GET
/api/tickets/{id}/exportAuth

Exportiert den Ticket-Verlauf als HTML-Dokument.

Feedback

Produktfeedback und Funktionswünsche einreichen.

GET
/api/feedbackAuth

Listet Feedback des aktuellen Nutzers mit Paginierung und Statusfilter.

POST
/api/feedbackAuth

Sendet neues Kundenfeedback (Kategorien u. a. allgemein, Feature, Bug). Bewertung 1–5; 28-Tage-Sperre für allgemeines Feedback.

Newsletter

Für den elizon-Newsletter anmelden.

GET
/api/newsletter/verifyÖffentlich

Bestätigt Newsletter-Anmeldung per E-Mail-Token und liefert eine HTML-Bestätigungsseite.

GET
/api/newsletter/unsubscribeÖffentlich

Ein-Klick-Abmeldung per HMAC-signiertem Link mit HTML-Bestätigung.

Berechtigungen

Freigaben und Berechtigungen für gemeinsame Ressourcen verwalten.

GET
/api/permissionsAuth

Liefert alle Berechtigungen zu einer Ressource. Erfordert manage_permissions.

POST
/api/permissionsAuth

Vergibt Berechtigungen auf eine Ressource per E-Mail-Adresse des Zielnutzers (view, start, stop, restart, console, Backup-Aktionen, settings, delete, manage_permissions).

PATCH
/api/permissions/{id}Auth

Aktualisiert eine bestehende Berechtigungsfreigabe.

DELETE
/api/permissions/{id}Auth

Widerruft eine Berechtigungsfreigabe.

GET
/api/permissions/{id}/detailsAuth

Liefert Details einer Einladung (nur für den eingeladenen Nutzer).

GET
/api/permissions/meAuth

Listet für den aktuellen Nutzer freigegebene Ressourcen; optional ?status=.

POST
/api/permissions/acceptAuth

Nimmt eine Berechtigungseinladung an.

POST
/api/permissions/declineAuth

Lehnt eine Berechtigungseinladung ab.

Subdomains

Subdomains und DNS-Einträge konfigurieren.

GET
/api/subdomainsAuth

Listet alle Subdomain-Einträge des Nutzers mit limitUsed/limitMax (max. 5). Antwort enthält srvService und srvProtocol für SRV.

POST
/api/subdomainsAuth

Legt einen DNS-Eintrag an (A, AAAA nur Proxmox, CNAME auf eigene Subdomain-FQDN, SRV nur Pterodactyl). SRV erfordert targetCnameSubdomain zu bestehendem CNAME/A/AAAA desselben Dienstes. Maximal fünf Einträge pro Nutzer.

GET
/api/subdomains/domainsAuth

Listet erlaubte aktive Domains für das Subdomain-Tool (nur id und Domain).

PATCH
/api/subdomains/{id}Auth

Aktualisiert einen Eintrag (nur Kommentar). Nur der Besitzer; schreibt mit id und userId.

DELETE
/api/subdomains/{id}Auth

Löscht den Eintrag und den zugehörigen Cloudflare-DNS-Eintrag. Nur der Besitzer.

Zahlungsmethoden (veraltet)

Veraltete Endpunkte zur Verwaltung von Zahlungsmethoden.

GET
/api/payment-methodsÖffentlich

[VERALTET – 410 Gone] Die Zahlungsmethoden-Funktion wurde entfernt.

POST
/api/payment-methodsÖffentlich

[VERALTET – 410 Gone] Die Zahlungsmethoden-Funktion wurde entfernt.

PATCH
/api/payment-methodsÖffentlich

[VERALTET – 410 Gone] Die Zahlungsmethoden-Funktion wurde entfernt.

DELETE
/api/payment-methodsÖffentlich

[VERALTET – 410 Gone] Die Zahlungsmethoden-Funktion wurde entfernt.

Business

Unternehmensbezogene Kontodaten, Verifizierung und Abrechnung.

GET
/api/business/eligibilityAuth

Prüft, ob der Nutzer für Business-Funktionen infrage kommt.

GET
/api/business/verificationAuth

Liefert Status und Details der Business-Verifizierung.

POST
/api/business/verificationAuth

Reicht Unterlagen zur Business-Verifizierung zur Prüfung ein.

GET
/api/business/verification/documents/{id}Auth

Lädt ein Verifizierungsdokument herunter (nur für den Dokumentenbesitzer).

GET
/api/business/billingAuth

Liefert die Business-Rechnungskonfiguration.

POST
/api/business/billingAuth

Aktualisiert die Business-Rechnungskonfiguration.

DELETE
/api/business/billingAuth

Entfernt oder setzt die Business-Rechnungskonfiguration zurück.

GET
/api/business/fundAuth

Liefert den BusinessFund-Status (aktive Verträge, offene Anträge).

POST
/api/business/fundAuth

Beantragt einen neuen BusinessFund (Finanzierung für Services).

POST
/api/business/fund/{id}/acceptAuth

Nimmt ein BusinessFund-Angebot an (Zahlung über Mollie oder Guthaben).

POST
/api/business/fund/{id}/rejectAuth

Lehnt ein BusinessFund-Angebot ab.

POST
/api/business/fund/{id}/cancelAuth

Kündigt einen aktiven BusinessFund-Vertrag (Bindungsfrist wird beachtet).

POST
/api/business/fund/special-terminationAuth

Beantragt eine außerordentliche Kündigung eines BusinessFund-Vertrags.

GET
/api/business/fund/special-terminationAuth

Listet ausstehende Anträge auf außerordentliche Kündigung.

Affiliates

Partnerprogramm — Empfehlungslinks, Provisionen und Auszahlungen.

POST
/api/affiliates/validateAuth

Prüft einen Affiliate- bzw. Empfehlungscode.

GET
/api/affiliates/meAuth

Liefert Affiliate-Profil und Kennzahlen des Nutzers.

GET
/api/affiliates/me/commissionsAuth

Liefert die Provisionshistorie des Affiliates.

GET
/api/affiliates/me/coupon-usageAuth

Liefert Nutzungsstatistiken zum Affiliate-Gutscheincode.

GET
/api/affiliates/me/tax-infoAuth

Liefert die steuerlichen Angaben des Affiliates.

PUT
/api/affiliates/me/tax-infoAuth

Aktualisiert steuerliche Daten; Adresse und Name kommen aus dem Profil, aus dem Body werden nur ustId, taxNumber und kleinunternehmer gelesen.

PATCH
/api/affiliates/me/payout-methodAuth

Aktualisiert die Auszahlungsmethode (Bankverbindung).

GET
/api/affiliates/me/payout-requestsAuth

Listet Auszahlungsanträge.

POST
/api/affiliates/me/payout-requestsAuth

Erstellt einen neuen Auszahlungsantrag.

POST
/api/affiliates/me/convert-to-creditAuth

Wandelt Affiliate-Guthaben in Kontoguthaben um.

GET
/api/affiliates/me/credit-notesAuth

Listet Affiliate-Gutschriften.

GET
/api/affiliates/me/credit-notes/{id}/downloadAuth

Lädt eine Gutschrift als PDF herunter.

POST
/api/affiliates/me/credit-note/previewAuth

Zeigt eine Vorschau der Gutschrift vor der Erstellung.

POST
/api/affiliates/me/credit-note/{id}/confirmAuth

Bestätigt und finalisiert eine Gutschrift.