API-Tokens und ein erstes Beispiel

Die vollständige Beschreibung aller Endpunkte, Grenzen und Fehler steht in der API-Dokumentation. Hier geht es um das Token und eine erste Anfrage.

Ein Token anlegen

1. 1

   Öffnen Sie Konto, API-Zugang und drücken Sie Token anlegen. Ist Ihre Anmeldung älter als 10 Minuten, bestätigen Sie kurz, dass Sie es sind.

2. 2

   Geben Sie einen Namen ein, etwa „Discord-Bot“.

3. 3

   Wählen Sie die Berechtigungen: Lesen (Server, Zustand, Auslastung, Adressen, Rechnungen), Server steuern (Ein/Aus und Konsole), Dateien zum Ansehen oder Bearbeiten, Backups (auflisten und anlegen) und Automationen (lesen, anlegen, ändern und löschen).

4. 4

   Wählen Sie, für welche Server es gilt (alle oder ausgewählte), und wie lange es gültig ist: 30 Tage, 90 Tage, 1 Jahr oder unbegrenzt.

5. 5

   Drücken Sie Token erzeugen und kopieren Sie das Token sofort: Es wird nur dieses eine Mal gezeigt.

Ein Token kann nie mehr als Sie selbst. In der Liste sehen Sie die letzten vier Zeichen, wann und von wo es zuletzt benutzt wurde und bis wann es gilt. Widerrufen Sie es durch Halten; alles, was es benutzt, hört sofort auf zu funktionieren.

Eine erste Anfrage

Legen Sie das Token als Umgebungsvariable ab, damit es nicht im Skript selbst steht:

export GF_TOKEN="gf_…"

Diese Anfrage listet Ihre Server mit Name und Zustand. Jede Anfrage trägt das Token im Header Authorization:

curl https://api.goodflare.io/api/v1/servers \
  -H "Authorization: Bearer $GF_TOKEN"

Einen Server neu starten (dafür braucht das Token Server steuern):

curl -X POST https://api.goodflare.io/api/v1/servers/SERVER_ID/power \
  -H "Authorization: Bearer $GF_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"signal":"restart"}'

Grenzen

• Bis zu 20 Tokens je Konto.
• 120 Anfragen pro Minute je Token, 300 für alle Tokens eines Kontos zusammen.
• Kündigen, neu installieren oder löschen geht über die API nicht.
• Jede Aktion steht in der Aktivität des Servers, mit dem Namen des Tokens.