Entwickler-API

Deine Server, aus deinem eigenen Code.

Eine REST-API mit OpenAPI-Dokument. Bestell, verlängere und upgrade Server, steuere sie und erfahre per signiertem Webhook, was passiert.

$ export EXY_API_TOKEN="exy_…"
$ curl "https://api.exy.sh/v1/servers?limit=10" \
-H "Authorization: Bearer $EXY_API_TOKEN"

Listet deine Server, zehn pro Seite. Den Token erstellst du im Dashboard unter Einstellungen → API.

Was dein Code damit kann

All das steht heute im OpenAPI-Dokument, jeweils mit dem Scope, den die Anfrage braucht.

Server bestellen

Lass dir einen Server per Angebot berechnen und bestell ihn, bezahlt aus deinem Guthaben. Ein Idempotency-Key sorgt dafür, dass eine wiederholte Bestellung nur einmal abgerechnet wird.

Verlängern und upgraden

Verlängere einen Server um eine weitere Laufzeit oder heb ihn auf ein größeres Paket, beides aus deinem Guthaben. Oder lass ihn sich selbst verlängern.

Steuern

Starten, stoppen, neu starten und neu installieren, das Login-Passwort setzen, eine Browser-Konsole öffnen und jede Aktion bis zum Ende verfolgen.

Firewall

Schalte die Firewall eines Servers ein oder aus, wende eine Vorlage an und füge eingehende Freigaben hinzu, ersetze oder entferne sie.

Snapshots und Backups

Snapshots und Backups anlegen, wiederherstellen und löschen und Aufgaben für einen Server planen.

Webhooks

Erfahre, wenn ein Server bereit, gesperrt, entsperrt oder gelöscht ist oder eine Bestellung erstattet wurde. Jede Zustellung ist mit HMAC-SHA256 signiert.

Die Grundregeln

Basis-URL
https://api.exy.sh/v1
Authentifizierung
Ein Bearer-Token, das mit exy_ beginnt und auf die gewählten Scopes beschränkt ist. Es läuft nach höchstens 365 Tagen ab.
Limits
60 Anfragen pro Minute und Konto, über alle Tokens des Kontos. Darüber antwortet die API mit 429 und Retry-After.
Fehler
Jeder Fehler hat dieselbe Form: einen stabilen Code für dein Programm und eine Meldung für Menschen.
Kompatibilität
Innerhalb von /v1 kommen nur Endpunkte, optionale Felder und Antwortfelder hinzu. Alles andere kommt als /v2.

Dokumentation

Du verkaufst Server an eigene Kunden? Zum Reseller-Programm.

Dein Server ist nur eine Zahlung entfernt.

Windows oder Linux, fünf Standorte, kein Abo.

Frage stellen
System
Paket
Standort
 

Im Voraus bezahlt. Nichts verlängert sich von selbst.