DokumentationAPI Reference

Dateien

Dateien auflisten, lesen, schreiben, kopieren, löschen, komprimieren und mehr.

GET/servers/:id/files

Verzeichnisinhalt auflisten.

Query-Parameter

NameTypeRequiredDescription
directorystringNoVerzeichnispfad (Standard: /)
curl "https://www.mado-hosting.com/api/v1/servers/srv_abc123/files?directory=/plugins" \
  -H "Authorization: Bearer rsk_your_key"
POST/servers/:id/files

Dateioperationen ausführen. Aktion wird im Body als action-Feld übergeben.

Verfügbare Aktionen: read, write, delete, bulk_delete, copy, mkdir, rename, compress, decompress, download_url, upload_url

Datei lesen

Body-Parameter

NameTypeRequiredDescription
action"read"Yes
filestringYesDateipfad
curl -X POST "https://www.mado-hosting.com/api/v1/servers/srv_abc123/files" \
  -H "Authorization: Bearer rsk_your_key" \
  -H "Content-Type: application/json" \
  -d '{ "action": "read", "file": "/server.properties" }'

Datei schreiben

Body-Parameter

NameTypeRequiredDescription
action"write"Yes
filestringYesDateipfad
contentstringYesDateiinhalt
curl -X POST "https://www.mado-hosting.com/api/v1/servers/srv_abc123/files" \
  -H "Authorization: Bearer rsk_your_key" \
  -H "Content-Type: application/json" \
  -d '{ "action": "write", "file": "/motd.txt", "content": "Welcome!" }'

Datei löschen

Body-Parameter

NameTypeRequiredDescription
action"delete"Yes
filestringYesDateipfad

Mehrere Dateien löschen

Body-Parameter

NameTypeRequiredDescription
action"bulk_delete"Yes
rootstringYesWurzelverzeichnis
filesstring[]YesDateipfade (max 100)
curl -X POST "https://www.mado-hosting.com/api/v1/servers/srv_abc123/files" \
  -H "Authorization: Bearer rsk_your_key" \
  -H "Content-Type: application/json" \
  -d '{ "action": "bulk_delete", "root": "/logs", "files": ["latest.log", "debug.log"] }'

Datei kopieren

Body-Parameter

NameTypeRequiredDescription
action"copy"Yes
locationstringYesQuelldateipfad

Verzeichnis erstellen

Body-Parameter

NameTypeRequiredDescription
action"mkdir"Yes
directorystringYesElternverzeichnis
namestringYesName des neuen Verzeichnisses

Umbenennen

Body-Parameter

NameTypeRequiredDescription
action"rename"Yes
rootstringYesWurzelverzeichnis
fromstringYesAktueller Name
tostringYesNeuer Name

Komprimieren

Body-Parameter

NameTypeRequiredDescription
action"compress"Yes
rootstringYesWurzelverzeichnis
filesstring[]YesDateien zum Komprimieren
namestringNoArchivname
extensionstringNoFormat (Standard: zip)

Entpacken

Body-Parameter

NameTypeRequiredDescription
action"decompress"Yes
rootstringYesWurzelverzeichnis
filestringYesArchivdatei

Download URL

Body-Parameter

NameTypeRequiredDescription
action"download_url"Yes
filestringYesDateipfad

Upload URL

Body-Parameter

NameTypeRequiredDescription
action"upload_url"Yes
Die Upload-URL ist temporär. Lade die Datei mit einem PUT-Request an die URL hoch.