Zum Inhalt springen

-10 % auf Ihren ersten Monat-10 % 1. Monat

Was möchten Sie hosten?

Steuern Sie Ihre Server aus Ihren eigenen Tools

Die API des HelloServ-Kundenbereichs öffnet Ihre Gameserver, VPS und dedizierten Server für Ihre Skripte, Ihr Monitoring und Ihre Dashboards: Live-Status, Start und Stopp, Neuinstallation, Rechnungen und Serverbestellungen, bezahlt mit Ihrem Guthaben.

terminal

$ curl https://panel.helloserv.fr/api/v1/services \
    -H "Authorization: Bearer $HELLOSERV_KEY"

{"data": [
  {"id": 48213, "name": "vps-prod-1", "type": "vps",
   "product": "vpsryzen", "status": "active",
   "primary_ip": "203.0.113.24",
   "actions": {"power": true, "reinstall": true}},
  {"id": 31877, "name": "survie-mc", "type": "game",
   "product": "minecraft", "status": "active",
   "primary_ip": "198.51.100.7",
   "actions": {"power": true, "reinstall": false}}
]}

Alles aus dem Panel, direkt aus Ihrem Code

Eine REST-API mit JSON über HTTPS. Jeder Schlüssel erhält nur die Rechte, die Sie ihm geben.

  • Ihre Dienste mit Ausstattung und IP-Adressen auflistenGET /servicesLesen
  • Den Live-Status eines Servers abfragenGET /services/{id}/statusLesen
  • Einen Server starten, neu starten oder stoppenPOST /services/{id}/powerStromsteuerung
  • Einen VPS oder dedizierten Server neu installierenPOST /services/{id}/reinstallNeuinstallation
  • Ihre Rechnungen als PDF herunterladenGET /invoices/{number}/pdfLesen
  • Einen Gameserver oder VPS mit Ihrem Guthaben bestellenPOST /ordersBestellung

Die Dokumentation beschreibt außerdem Konto und Guthaben, den Katalog mit Ihren Preisen, den Bestellverlauf, die Limits und die Fehlercodes.

Verbinden Sie die API mit den Tools, die Sie bereits nutzen

Für die meisten Anwendungen reichen wenige Zeilen Skript. In den Beispielen steht $API für https://panel.helloserv.fr/api/v1 und $HELLOSERV_KEY für Ihren Schlüssel.

Monitoring und Dashboards

Zeigen Sie den Status Ihrer Server neben dem Rest Ihrer Infrastruktur an, in Grafana, Uptime Kuma oder Ihrem eigenen Tool, und lösen Sie einen Alarm aus, wenn einer stoppt.

supervision.sh

$ curl -s $API/services/48213/status \
    -H "Authorization: Bearer $HELLOSERV_KEY" | jq .data.power
"running"

Skripte, geplante Aufgaben und Deployments

Starten Sie einen Gameserver nach einem Mod-Update neu, installieren Sie einen Test-VPS aus Ihrer CI-Pipeline neu oder stoppen Sie einen Server nachts per geplanter Aufgabe.

deploy.yml

- name: Restart the server after the update
  run: >
    curl -X POST
    https://panel.helloserv.fr/api/v1/services/31877/power
    -H "Authorization: Bearer ${{ secrets.HELLOSERV_KEY }}"
    -H "Content-Type: application/json"
    -d '{"action": "restart"}'

Wiederverkauf von Gameservern und VPS

Ihr Shop bestellt den Server mit Ihrem Guthaben zum Preis des Kundenbereichs und übergibt ihn mit seiner IP-Adresse an Ihren Kunden. Ihre Preise legen Sie selbst fest.

commande.sh

$ curl -X POST $API/orders \
    -H "Authorization: Bearer $HELLOSERV_KEY" \
    -H "Idempotency-Key: commande-1042" \
    -H "Content-Type: application/json" \
    -d '{"type": "minecraft", "offer_id": 2, "period": "monthly"}'

Agenturen und Serverparks

Verwalten Sie die Server Ihrer Kunden aus Ihrem Betriebstool, mit einem Schlüssel pro Projekt, und holen Sie jeden Monat die Rechnungen als PDF für Ihre Buchhaltung ab.

factures.sh

$ curl -s "$API/invoices?per_page=100" \
    -H "Authorization: Bearer $HELLOSERV_KEY"
$ curl -o INV-2026-001234.pdf \
    $API/invoices/INV-2026-001234/pdf \
    -H "Authorization: Bearer $HELLOSERV_KEY"

Ein Schlüssel pro Tool, mit eigenen Rechten und Adressen

Schlüssel werden im Kundenbereich unter Mein Profil und dann Sicherheit erstellt. Dafür ist die Zwei-Faktor-Authentifizierung nötig, und jeder Schlüssel wird nur einmal angezeigt.

Formular zum Erstellen eines API-Schlüssels im HelloServ-Kundenbereich, mit den Rechten Lesen, Stromsteuerung, Neuinstallation und Bestellung und dem Feld für erlaubte IP-Adressen
Erstellen eines Schlüssels: ein Name, einzeln angehakte Rechte und die erlaubten IP-Adressen.
Zwei API-Schlüssel im Kundenbereich mit ihren Rechten, ihrer letzten Nutzung und ihren erlaubten IP-Adressen
Jeder Schlüssel zeigt seine Rechte, seine letzte Nutzung und die Adressen, von denen er akzeptiert wird.
Protokoll der letzten API-Aufrufe mit Route, Antwortcode, Schlüssel und IP-Adresse
Die letzten Aufrufe, Ablehnungen inklusive: Ein Aufruf von einer nicht erlaubten Adresse wird abgewiesen und erscheint hier.

Bestellen Sie Server mit dem Guthaben Ihres Kontos

Preise, Mehrwertsteuer und Rechnung sind dieselben wie im Kundenbereich, und der Server wird in 60 Sekunden bereitgestellt.

  1. 01Laden Sie Ihr Guthaben im Kundenbereich auf und erstellen Sie einen Schlüssel mit dem Recht Bestellung, das nie voreingestellt ist.
  2. 02Lesen Sie den Katalog: die verfügbaren Angebote und ihre Preise für Ihr Konto, inklusive Mehrwertsteuer.
  3. 03Fordern Sie mit dry_run ein Angebot an: der genaue Preis, ohne etwas zu bestellen.
  4. 04Bestellen Sie mit einem Idempotenzschlüssel: Doppelt gesendet, wird die Bestellung nur einmal ausgeführt.

terminal

$ curl -X POST https://panel.helloserv.fr/api/v1/orders \
    -H "Authorization: Bearer $HELLOSERV_KEY" \
    -H "Idempotency-Key: commande-7f3a9c21" \
    -H "Content-Type: application/json" \
    -d '{"type": "vpsintel", "offer_id": 3,
         "period": "monthly", "os": "debian12"}'

{"data": {
  "order": {"id": 42, "status": "paid"},
  "invoice": {"number": "INV-2026-001234", "status": "paid",
              "total": 9.60},
  "services": [{"id": 5678, "name": "vps-2", "status": "pending"}],
  "balance": 40.40
}}

Eine Dokumentation mit einem Beispiel für jede Route

Jede Route hat ihre curl-Anfrage und ihre Antwort. Das Hilfecenter erklärt Schritt für Schritt, wie Sie einen Schlüssel erstellen, ihn auf Ihre IP-Adressen beschränken und eine erste Bestellung aufgeben.

Dokumentation der HelloServ-API, geöffnet im Abschnitt Bestellungen
Kostet die API extra?
Nein. Sie gehört zum Kundenbereich und funktioniert mit allen Ihren Diensten.
Welche Dienste lassen sich steuern?
Gameserver, VPS und dedizierte Server. Status und Stromsteuerung funktionieren für alle drei; die Neuinstallation gilt für VPS und dedizierte Server.
Kann ich einen dedizierten Server über die API bestellen?
Noch nicht: Die API bestellt Gameserver und VPS. Einen dedizierten Server bestellen Sie über die Website oder den Kundenbereich.
Wie schütze ich einen Schlüssel?
Geben Sie ihm nur die nötigen Rechte und beschränken Sie ihn auf die IP-Adressen Ihrer Server, höchstens 20. Wird er bekannt, widerrufen Sie ihn im Kundenbereich: Er wird sofort abgelehnt.
Gibt es Limits?
120 Anfragen pro Minute und Schlüssel sowie 10 Bestellungen pro Tag mit demselben Schlüssel. Darüber antwortet die API mit dem Code 429 und der Wartezeit.

Ihr Server läuft 60 Sekunden nach der Zahlung.

Angebot wählen, online bezahlen: Der Server richtet sich selbst ein.