Dokumentation

API-Version v1 · zuletzt aktualisiert 2026-10-02

Alles, was im Dashboard geht, geht auch über HTTP. Die API ist eine schlichte JSON-API, die CLI ein dünner Mantel darum, beide nutzen dieselben Tokens.

Basis-URL und Authentifizierung

Alle Anfragen gehen an https://api.media-host.online/v1. Authentifiziert wird mit einem Bearer-Token aus Einstellungen → API-Schlüssel. Tokens mit mh_live_ arbeiten auf dem echten Konto; mh_test_-Tokens treffen eine Sandbox, die Uploads annimmt, aber nie öffentlich ausliefert.

curl https://api.media-host.online/v1/account \
  -H "Authorization: Bearer mh_live_3f9a...c21e"
{
  "id": "acc_Qm4xT",
  "plan": "studio",
  "storage_used_bytes": 41288312902,
  "transfer_month_bytes": 612338190021,
  "collections": 4
}

CLI installieren

Die CLI ist eine einzelne statische Binärdatei für Linux und macOS. Sie liest MH_TOKEN aus der Umgebung oder aus ~/.config/mh/config.toml.

curl -fsSL https://media-host.online/install.sh | sh
mh auth login          # schreibt ein Token in die Konfigurationsdatei
mh ls                  # Sammlungen auflisten
mh ls wochenshow       # Dateien einer Sammlung auflisten

Ratenlimits

600 Anfragen pro Minute und Token für Metadaten. Uploads sind nicht nach Anzahl begrenzt, nur nach Parallelität: 8 gleichzeitige Chunks pro Token. Darüber gibt es 429 mit Retry-After-Header.

Fehler

Fehler kommen als JSON mit einem stabilen code, auf den Sie verzweigen können, und einer menschenlesbaren message, auf die Sie besser nicht verzweigen.

HTTP/1.1 404 Not Found
{ "error": { "code": "file_not_found", "message": "No file f_9ZZZ in collection wochenshow" } }

Anleitungen