So erstellst du einen API-Schlüssel und verwaltest deinen Server über die Panel-API

Alles, was du im Panel per Klick erledigst – Server starten, einen Befehl in die Konsole schicken, eine Datei bearbeiten –, geht auch per HTTP-Anfrage. So kann ein Discord-Bot den Minecraft-Server per Befehl neu starten, ein Skript den Server nach einem Absturz wieder hochfahren oder eine Routine täglich eine Konfigurationsdatei sichern.

Diese Anleitung zeigt, wie du den Schlüssel für diesen Zugriff erstellst und für die häufigsten Aufgaben nutzt.

1. Was der API-Schlüssel kann

Der Schlüssel handelt im Namen deines Kontos. Er hat keine eigenen Berechtigungen: Was du im Panel darfst, darf er auch, auf allen Servern des Kontos. Die meistgenutzten Aktionen sind:

• Energie — starten, stoppen, neu starten und hart beenden.
• Konsole — Befehle senden, etwa say, whitelist add oder save-all.
• Verbrauch — Serverstatus sowie CPU-, Speicher- und Festplattennutzung auslesen.
• Dateien — Ordner auflisten, Dateien lesen und schreiben.
• Backups und Zeitpläne — dieselben, die in den Reitern des Servers erscheinen.

2. Den Schlüssel erstellen

Das Panel zeigt die Beschriftungen womöglich auf Portugiesisch; der Originalname steht in Klammern.

1. Melde dich im Panel unter app.redhosting.com.br an.
2. Klicke im Seitenmenü auf Konto (Conta) – oder öffne direkt app.redhosting.com.br/account.
3. Scrolle zum Schlüsselbereich am Ende der Seite und klicke auf den Reiter API-Schlüssel (Chave API) – daneben ist der Reiter für SSH-Schlüssel.
4. Trage unter Beschreibung (Descrição) ein, wofür der Schlüssel ist – zum Beispiel discord bot. Mindestens 4 Zeichen, und genau dieser Name sagt dir Monate später, welchen Schlüssel du löschen musst.
5. Trage unter Erlaubte IPs (IPs Permitidos) die IP der Maschine ein, die den Schlüssel nutzen wird, eine pro Zeile. Leer gelassen ist die Nutzung von überall im Internet möglich.
6. Klicke auf Erstellen (Criar).

Das Fenster Dein API-Schlüssel (Sua Chave API) zeigt den vollständigen Schlüssel, der mit ptlc_ beginnt. Kopiere ihn und bewahre ihn sicher auf: Er wird nicht noch einmal angezeigt. Verlierst du ihn, lösche den Schlüssel und erstelle einen neuen.

3. Die Server-Kennung finden

Jeder Aufruf muss angeben, auf welchen Server er wirkt. Die Kennung steht in der Adressleiste, wenn du den Server im Panel öffnest:

https://app.redhosting.com.br/server/1a2b3c4d

Die Kennung ist der Teil nach /server/ – im Beispiel 1a2b3c4d. Die folgenden Beispiele verwenden stattdessen DEIN_SERVER und für den Schlüssel DEIN_SCHLUESSEL.

4. Erster Test

Jede Anfrage enthält den Schlüssel und den Hinweis, dass im JSON-Format kommuniziert wird. Dieser Befehl listet die Server des Kontos auf und bestätigt, dass der Schlüssel funktioniert:

curl https://app.redhosting.com.br/api/client \
  -H "Authorization: Bearer DEIN_SCHLUESSEL" \
  -H "Accept: application/json"

Die Antwort enthält einen Eintrag pro Server. Das Feld identifier ist jeweils dieselbe Kennung wie im vorigen Schritt.

5. Den Server verwalten

Prüfen, ob er läuft und wie viel er verbraucht

curl https://app.redhosting.com.br/api/client/servers/DEIN_SERVER/resources \
  -H "Authorization: Bearer DEIN_SCHLUESSEL" \
  -H "Accept: application/json"

Das Feld current_state nennt den Status: running, starting, stopping oder offline. Unter resources stehen Speicher und Festplatte in Bytes und die CPU in Prozent.

Starten, stoppen und neu starten

curl -X POST https://app.redhosting.com.br/api/client/servers/DEIN_SERVER/power \
  -H "Authorization: Bearer DEIN_SCHLUESSEL" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"signal": "restart"}'

signal akzeptiert start, stop, restart und kill. Nimm lieber stop: Es fährt geordnet herunter und lässt den Server speichern, was im Arbeitsspeicher liegt. kill beendet sofort, wie Stecker ziehen, und kann die Welt oder offene Dateien beschädigen.

Einen Befehl an die Konsole senden

curl -X POST https://app.redhosting.com.br/api/client/servers/DEIN_SERVER/command \
  -H "Authorization: Bearer DEIN_SCHLUESSEL" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"command": "say Neustart in 5 Minuten"}'

Der Befehl landet in der Konsole genau so, als hättest du ihn dort eingetippt. Der Server muss laufen; ist er aus, lautet die Antwort Fehler 502.

Dateien lesen und schreiben

Einen Ordner auflisten:

curl "https://app.redhosting.com.br/api/client/servers/DEIN_SERVER/files/list?directory=/" \
  -H "Authorization: Bearer DEIN_SCHLUESSEL" \
  -H "Accept: application/json"

Eine Datei lesen – die Antwort ist der reine Inhalt, kein JSON:

curl "https://app.redhosting.com.br/api/client/servers/DEIN_SERVER/files/contents?file=/server.properties" \
  -H "Authorization: Bearer DEIN_SCHLUESSEL"

Zum Schreiben ist der Anfragetext der gesamte neue Inhalt der Datei, der den alten ersetzt:

curl -X POST "https://app.redhosting.com.br/api/client/servers/DEIN_SERVER/files/write?file=/motd.txt" \
  -H "Authorization: Bearer DEIN_SCHLUESSEL" \
  -H "Accept: application/json" \
  --data-binary @motd.txt

Übersicht der Endpunkte. Alle beginnen mit https://app.redhosting.com.br/api/client/servers/DEIN_SERVER:

6. Beispiel: den Server nach einem Absturz wieder starten

Ein Node.js-Skript (Version 18 oder neuer), das den Status prüft und den Server startet, wenn er aus ist. Der Schlüssel kommt aus einer Umgebungsvariable, nicht aus dem Code – so landet er nicht mit dem Rest auf GitHub.

const PANEL = 'https://app.redhosting.com.br/api/client';
const SERVER = 'DEIN_SERVER';
const headers = {
  Authorization: `Bearer ${process.env.PANEL_API_KEY}`,
  Accept: 'application/json',
  'Content-Type': 'application/json',
};

async function check() {
  const response = await fetch(`${PANEL}/servers/${SERVER}/resources`, { headers });
  if (!response.ok) throw new Error(`API antwortete ${response.status}`);

  const { attributes } = await response.json();
  if (attributes.current_state === 'offline') {
    await fetch(`${PANEL}/servers/${SERVER}/power`, {
      method: 'POST',
      headers,
      body: JSON.stringify({ signal: 'start' }),
    });
    console.log('Server war aus – wird gestartet.');
  }
}

check().catch((error) => console.error(error.message));

Alle paar Minuten über einen System-Zeitplan ausgeführt, startet es den Server nach einem Ausfall wieder. Nicht zu kurz takten: Das Anfragelimit steht im nächsten Abschnitt.

7. Häufige Fehler

8. Sicherheit

• Ein Schlüssel pro Verwendung. Einer für den Bot, einer für das Backup-Skript. Sickert einer durch, löschst du nur ihn, und der Rest läuft weiter.
• Trage Erlaubte IPs ein, wann immer du weißt, von wo der Schlüssel genutzt wird.
• Speichere den Schlüssel in einer Umgebungsvariable oder in einer .env-Datei, die in der .gitignore steht, nie im Code.
• Prüfe „Zuletzt verwendet“ bei jedem Schlüssel im Reiter API-Schlüssel. Ein Schlüssel, den du nicht mehr nutzt, der aber weiter genutzt wird, ist durchgesickert.
• Zum Widerrufen klickst du auf den Papierkorb neben dem Schlüssel. Die Löschung gilt sofort für alle Anfragen.