api.apps.files. Jede Methode nimmt zuerst die App-ID und dann einen Pfad innerhalb der App. Pfade sind höchstens 256 Zeichen lang.
Die Beispiele verwenden den Client api aus Client erstellen. appId ist die ID einer deiner Apps: api.account.me() listet sie auf.
Ein Verzeichnis auflisten
files.list(appId, path?) listet ein Verzeichnis auf (das Stammverzeichnis der App, wenn path fehlt).
Ein Verzeichnis, das nicht existiert, ergibt 404
FILE_NOT_FOUND. Ein Pfad, den der Dateimanager nicht freigibt, ergibt 403 BLOCKED_PATH.
Eine Datei lesen
files.read(appId, path) gibt die Bytes der Datei als Uint8Array zurück. Dateien sind auf 10 MB begrenzt: Eine größere ergibt 413 FILE_TOO_LARGE.
Eine Datei schreiben
files.write(appId, path, content, { signal }) erstellt oder überschreibt eine Datei.
- Ein
stringwird als reiner Text gesendet. - Ein
Uint8Arraywird als Base64 gesendet, sodass jeder Binärinhalt unverändert ankommt. - Leerer Inhalt (
""oder leere Bytes) erstellt eine leere Datei.
FILE_TOO_LARGE (Status 0) fehl, bevor etwas gesendet wird. Inhalt über 1 MiB wird wie ein Upload ohne Timeout gesendet: Übergib { signal }, um ihn abzubrechen. Für größere Dateien verwende apps.commit().
Das Schreiben startet die App nicht neu. Rufe
apps.restart() auf, um die Änderung anzuwenden.Eine Datei verschieben oder umbenennen
Eine Datei löschen
Fehler
Unter Fehler findest du die Codes, die jeder Aufruf zurückgeben kann.
Nächste Schritte
Umgebungsvariablen
Die Variablen einer App lesen und ändern.
API-Referenz des Dateimanagers
Die REST-Endpunkte hinter diesen Methoden.
Dateien über die CLI verwalten
Dieselben Aktionen im Terminal.

