---
title: "So erstellst du einen API-Schlüssel und verwaltest deinen Server über die Panel-API"
description: "Erstelle in deinem Panel-Konto einen API-Schlüssel und nutze ihn, um den Server per Skript zu starten, zu stoppen und neu zu starten, Befehle zu senden und Dateien zu bearbeiten. Experimentelle Funktion, ohne Support durch das Team."
url: "https://redhosting.com.br/de/base-de-conhecimento/como-criar-uma-chave-de-api-e-gerenciar-seu-servidor-pela-api-do-painel"
type: "article"
language: "de"
category: "Sonstiges"
published: "2026-09-24"
translations:
  pt-BR: "https://redhosting.com.br/base-de-conhecimento/como-criar-uma-chave-de-api-e-gerenciar-seu-servidor-pela-api-do-painel.md"
  en: "https://redhosting.com.br/en/base-de-conhecimento/como-criar-uma-chave-de-api-e-gerenciar-seu-servidor-pela-api-do-painel.md"
  es: "https://redhosting.com.br/es/base-de-conhecimento/como-criar-uma-chave-de-api-e-gerenciar-seu-servidor-pela-api-do-painel.md"
  de: "https://redhosting.com.br/de/base-de-conhecimento/como-criar-uma-chave-de-api-e-gerenciar-seu-servidor-pela-api-do-painel.md"
---

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

Erstelle in deinem Panel-Konto einen API-Schlüssel und nutze ihn, um den Server per Skript zu starten, zu stoppen und neu zu starten, Befehle zu senden und Dateien zu bearbeiten. Experimentelle Funktion, ohne Support durch das Team.

- Anleitung der RedHosting-Wissensdatenbank — Kategorie: Sonstiges
- HTML-Seite: https://redhosting.com.br/de/base-de-conhecimento/como-criar-uma-chave-de-api-e-gerenciar-seu-servidor-pela-api-do-painel
- Veröffentlicht am: 2026-09-24 · Sprache: de

🧪**Experimentelle Funktion – ohne Support**: Die Panel-API steht allen offen, die ihren eigenen Server automatisieren wollen, aber **RedHosting leistet dafür keinen Support**. Das Team hilft nicht beim Erstellen von Skripten, debuggt keine Integrationen und haftet nicht für das, was ein Skript auf deinem Server ausführt – auch nicht, wenn es ihn versehentlich herunterfährt, Dateien löscht oder Befehle sendet. Das Verhalten der API kann sich ohne Ankündigung ändern. Der Support deckt weiterhin den Dienst selbst ab: Server offline, Panel, Netzwerk und Abrechnung.

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.

  ⚠️**Behandle den Schlüssel wie dein Passwort**: Wer den Schlüssel hat, kontrolliert alle deine Server, ohne dein Passwort oder die Zwei-Faktor-Bestätigung zu brauchen. Veröffentliche den Schlüssel nie auf GitHub, in einem Screenshot oder in einem Discord-Kanal.

## 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](https://app.redhosting.com.br) an.
2. Klicke im Seitenmenü auf **Konto** (Conta) – oder öffne direkt [app.redhosting.com.br/account](https://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.

  💡**Tipp**: Läuft das Skript auf einer VPS oder einem Bot-Server von RedHosting, trag dessen IP unter Erlaubte IPs ein. Selbst wenn der Schlüssel dann durchsickert, funktioniert er von nirgendwo sonst.

## 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`:

    AktionMethodeEndpunkt

    Status und VerbrauchGET`/resources`
    Starten, stoppen, neu startenPOST`/power`
    KonsolenbefehlPOST`/command`
    Ordner auflistenGET`/files/list?directory=/`
    Datei lesenGET`/files/contents?file=/pfad`
    Datei schreibenPOST`/files/write?file=/pfad`
    Backups auflistenGET`/backups`

## 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.

  💡**Tipp**: Bevor du den Neustart automatisierst, finde heraus, warum der Server abstürzt. Ein Server, der wegen Speichermangels abstürzt, stürzt kurz nach dem Start wieder ab, und das Skript verdeckt nur das Problem. Die Anleitung [Mein Dienst ist offline: So findest du die Ursache](/de/base-de-conhecimento/meu-servico-esta-fora-do-ar-como-descobrir-a-causa) hilft dabei.

## 7. Häufige Fehler

    AntwortBedeutungWas tun

    **401**Der Schlüssel wurde nicht akzeptiert.Prüfe, ob du den ganzen Schlüssel samt `ptlc_` kopiert hast und ob der Header `Authorization: Bearer` lautet. Ein im Panel gelöschter Schlüssel funktioniert sofort nicht mehr.
    **403**Der Schlüssel funktioniert, aber nicht hier.Die IP, von der die Anfrage kam, steht nicht unter Erlaubte IPs, oder dein Konto ist Unterbenutzer des Servers ohne Berechtigung für diese Aktion.
    **404**Server oder Datei nicht gefunden.Prüfe die 8-stellige Kennung und den Dateipfad, der mit `/` beginnt.
    **409**Der Server kann das gerade nicht.Er wird installiert, übertragen oder ist gesperrt. Warte, bis das vorbei ist.
    **429**Zu viele Anfragen.Das Panel akzeptiert bis zu 256 Anfragen pro Minute und Konto. Verteile die Aufrufe.
    **502**Der Server muss laufen.Passiert, wenn du bei ausgeschaltetem Server einen Befehl sendest. Starte ihn vorher.

## 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.

  Bevor du das Skript laufen lässt

    ✓Der Schlüssel hat eine Beschreibung, die sagt, wofür er ist.

    ✓Unter Erlaubte IPs steht die IP der Maschine, die den Schlüssel nutzt.

    ✓Der Schlüssel liegt in einer Umgebungsvariable, außerhalb des Codes und außerhalb von Git.

    ✓Du hast den Schlüssel mit der Serverliste getestet und deine Liste erhalten.

    ✓Das Skript nutzt zum Herunterfahren `stop`, nicht `kill`.

    ✓Du weißt, dass die API experimentell ist und der Support nicht beim Skript hilft.

## Häufige Fragen

**Leistet RedHosting Support für die Panel-API?**

Nein. Die API ist eine experimentelle Funktion ohne Gewähr: Das Team hilft nicht beim Erstellen von Skripten, debuggt keine Integrationen und haftet nicht für das, was ein Skript auf dem Server ausführt. Der Support deckt weiterhin den Dienst selbst ab – Server offline, Panel, Netzwerk und Abrechnung.

**Wo erstelle ich den API-Schlüssel?**

Im Panel unter **Konto** (Conta) → Reiter **API-Schlüssel** (Chave API), im Bereich am Ende der Seite. Beschreibung und erlaubte IPs ausfüllen und auf Erstellen klicken.

**Ich habe den Schlüssel verloren. Kann ich ihn wieder ansehen?**

Nein. Der Schlüssel wird nur einmal angezeigt, beim Erstellen. Lösche den alten über den Papierkorb und erstelle einen neuen.

**Auf welche Server gibt der Schlüssel Zugriff?**

Auf alle Server deines Kontos, mit denselben Berechtigungen, die du im Panel hast. Es gibt keinen Schlüssel für nur einen Server – deshalb lohnt es sich, Erlaubte IPs einzutragen und einen Schlüssel pro Anwendung zu nutzen.

**Wo finde ich die Server-Kennung?**

In der Adressleiste, wenn du den Server im Panel öffnest: der 8-stellige Code nach `/server/`.

**Kann ich den Schlüssel in einem Discord-Bot nutzen?**

Ja, wenn du ihn in einer Umgebungsvariable speicherst und nie im Code. Und beschränke im Bot, wer die Befehle auslösen darf: Ein Herunterfahren-Befehl, den der ganze Discord-Server nutzen kann, ist ein Ausschalter für jeden.

**Gibt es ein Anfragelimit?**

Ja, 256 pro Minute. Darüber antwortet die API mit 429, bis die Minute um ist.

## Navigation — Sonstiges (Artikel 9 von 9)

- Vorheriger Artikel: [Willkommen in der Dokumentation von RedHosting](https://redhosting.com.br/de/base-de-conhecimento/bem-vindo-ao-git-da-redhosting.md) — https://redhosting.com.br/de/base-de-conhecimento/bem-vindo-ao-git-da-redhosting
- Zurück zur Wissensdatenbank: https://redhosting.com.br/de/base-de-conhecimento

---

Hilfe bei diesen Schritten? 24/7-Support von RedHosting: suporte@redhosting.com.br · WhatsApp +55 11 98833-3902 · https://redhosting.com.br/discord

Weitere Anleitungen: https://redhosting.com.br/de/base-de-conhecimento.md