Reseller API v1

Über die REST-API lässt sich praktisch jede Funktion des Panels per Token steuern — Server starten/stoppen, Domains bestellen, Rechnungen bezahlen, Tickets schreiben und mehr. Jede Aktion, die du im Dashboard per Knopf auslöst, gibt es auch hier als Endpunkt.

Basis-URL
https://europe-reseller-hosting.de/api/v1
Authentifizierung
Authorization: Bearer TOKEN
So bekommst du ein Token

Im Dashboard unter Einstellungen → API ein Token erzeugen — oder per API, wenn du bereits ein Token besitzt (POST /tokens). Das Token wird nur einmal angezeigt, also sicher speichern. Token lassen sich pausieren und löschen.

# Beispiel: alle eigenen Server abrufen
curl -H "Authorization: Bearer TOKEN" \
     https://europe-reseller-hosting.de/api/v1/servers

Antworten sind immer JSON: { "status": "ok", "data": … } bzw. { "status": "error", "error": "…", "code": 4xx }. POST-Bodies werden als JSON oder Form-Felder akzeptiert.

Account

GET /api/v1/me Account-Daten (E-Mail, Rolle, Guthaben)
POST /api/v1/me Profil aktualisieren
POST /api/v1/me/password Passwort ändern

Guthaben & Finanzen

GET /api/v1/balance Aktuelles Guthaben
GET /api/v1/transactions Guthaben-Bewegungen (letzte 100)
POST /api/v1/balance/charge Guthaben aufladen (erzeugt Zahlung)
GET /api/v1/invoices Alle Rechnungen
GET /api/v1/invoices/{id} Einzelne Rechnung
POST /api/v1/invoices/{id}/pay Rechnung mit Guthaben bezahlen

Dienste (Services)

GET /api/v1/services Alle gebuchten Dienste
GET /api/v1/services/{id} Einzelner Dienst
POST /api/v1/services/{id}/renew Dienst um 1 Monat verlängern
POST /api/v1/services/{id}/cancel Dienst kündigen

Server (KVM / Proxmox)

GET /api/v1/servers Alle Server
GET /api/v1/servers/{id}/status Live-Status (running/stopped, Uptime)
GET /api/v1/servers/{id}/stats CPU/RAM/Netz-Statistik
POST /api/v1/servers/{id}/start Server starten
POST /api/v1/servers/{id}/stop Server stoppen
POST /api/v1/servers/{id}/restart Server neu starten
POST /api/v1/servers/{id}/password Root-Passwort setzen
POST /api/v1/servers/{id}/console noVNC-Konsolen-Link erzeugen
POST /api/v1/servers/{id}/reinstall Server neu installieren

Domains

GET /api/v1/domains Alle Domains
GET /api/v1/domains/pricelist Preisliste aller TLDs
GET /api/v1/domains/check?domain=example.de Verfügbarkeit prüfen
POST /api/v1/domains/register Domain registrieren / transferieren
POST /api/v1/domains/{domain}/renew Domain verlängern
GET /api/v1/domains/{domain}/dns DNS-Zone abrufen
POST /api/v1/domains/{domain}/dns DNS-Zone setzen
GET /api/v1/domains/{domain}/ns Nameserver abrufen
POST /api/v1/domains/{domain}/ns Nameserver setzen
GET /api/v1/domains/{domain}/authcode Auth-Code (EPP) abrufen

Kontaktpersonen (Domain-Handles)

GET /api/v1/contacts Alle gespeicherten Personen
POST /api/v1/contacts Person anlegen
GET /api/v1/contacts/{id} Einzelne Person
POST /api/v1/contacts/{id} Person aktualisieren

Support / Tickets

GET /api/v1/tickets Alle Tickets
POST /api/v1/tickets Ticket erstellen
GET /api/v1/tickets/{id} Ticket inkl. Nachrichten
POST /api/v1/tickets/{id}/reply Nachricht schreiben
POST /api/v1/tickets/{id}/close Ticket schließen

Produkte & Aktivität

GET /api/v1/products Buchbare Produkte
GET /api/v1/activity Eigenes Aktivitätsprotokoll

API-Token-Verwaltung

GET /api/v1/tokens Eigene Tokens auflisten
POST /api/v1/tokens Neues Token erzeugen
POST /api/v1/tokens/{id}/pause Token pausieren / aktivieren
DELETE /api/v1/tokens/{id} Token löschen
GET /api/v1/logs API-Aufrufprotokoll (letzte 100)

Statuscodes

CodeBedeutung
200 / 201Erfolgreich
401Token fehlt, ungültig, pausiert oder abgelaufen
402Guthaben reicht nicht (z. B. Rechnung bezahlen)
403Kein Zugriff (falsches Konto, falsches Passwort)
404Objekt nicht gefunden
409Server-Konfiguration unvollständig
422Fehlende oder ungültige Parameter
429Rate-Limit überschritten
502Externer Dienst (Proxmox / Domain-Provider) nicht erreichbar