API-Zugang

REST API und API-Schlüssel: Zugriff erstellen, Berechtigungen setzen und Server per API automatisiert steuern.

API-Zugang

RespawnHost bietet eine REST API, mit der du Server programmatisch verwalten kannst. Über API-Keys authentifizierst du dich gegenüber der API.

Wofür ist die API?

Mit der API kannst du:

  • Server starten, stoppen und neustarten
  • Server-Status und Ressourcen abfragen
  • Backups erstellen und verwalten
  • Dateien hochladen und herunterladen
  • Account-Informationen und Guthaben abfragen

Die API eignet sich für Automatisierung, eigene Dashboards, Discord-Bots oder die Integration in bestehende Workflows.

API-Key erstellen

  1. Gehe zu Profil und dann zu API-Keys
  2. Klicke auf Neuen API-Key erstellen
  3. Vergib einen aussagekräftigen Namen (z.B. “Discord Bot” oder “Monitoring”)
  4. Wähle die Berechtigungen, die der Key haben soll
  5. Bestätige die Erstellung

Der API-Key wird einmalig vollständig angezeigt. Kopiere und speichere ihn sofort — nach dem Schließen des Dialogs kannst du den vollständigen Key nicht mehr einsehen.

Berechtigungen

Jeder API-Key kann mit eingeschränkten Berechtigungen erstellt werden:

  • Server lesen — Status und Informationen abfragen
  • Server verwalten — starten, stoppen, neustarten
  • Dateien — Dateizugriff über die API
  • Backups — Backups erstellen und verwalten
  • Account — Kontoinformationen lesen

Vergib nur die Berechtigungen, die tatsächlich benötigt werden.

API verwenden

Authentifiziere dich mit dem API-Key im Authorization-Header:

curl -H "Authorization: Bearer dein-api-key" \
  https://api.respawnhost.com/v1/servers

Sicherheitshinweise

  • Teile API-Keys niemals öffentlich (z.B. in Git-Repositories)
  • Nutze für jeden Anwendungsfall einen eigenen Key
  • Lösche nicht mehr benötigte Keys sofort
  • Bei Verdacht auf Kompromittierung: Key sofort löschen und neu erstellen