api.apps.files. Chaque méthode prend d’abord l’identifiant de l’application, puis un chemin dans l’application. Les chemins font au maximum 256 caractères.
Les exemples utilisent le client api présenté dans Créer le client. appId est l’identifiant de l’une de vos applications : api.account.me() les liste.
Lister un répertoire
files.list(appId, path?) liste un répertoire (la racine de l’application quand path est omis).
Un répertoire inexistant donne 404
FILE_NOT_FOUND. Un chemin que le gestionnaire de fichiers n’expose pas donne 403 BLOCKED_PATH.
Lire un fichier
files.read(appId, path) renvoie les octets du fichier sous forme de Uint8Array. Les fichiers sont limités à 10 Mo : un fichier plus volumineux donne 413 FILE_TOO_LARGE.
Écrire un fichier
files.write(appId, path, content, { signal }) crée ou écrase un fichier.
- Une
stringest envoyée en texte brut. - Un
Uint8Arrayest envoyé en base64, de sorte que tout contenu binaire est conservé à l’identique. - Un contenu vide (
""ou octets vides) crée un fichier vide.
FILE_TOO_LARGE (statut 0) avant tout envoi. Un contenu de plus de 1 MiB est envoyé sans timeout, comme un envoi : passez { signal } pour l’annuler. Pour les fichiers plus volumineux, utilisez apps.commit().
L’écriture ne redémarre pas l’application. Appelez
apps.restart() pour appliquer la modification.Déplacer ou renommer un fichier
Supprimer un fichier
Erreurs
Voir Erreurs pour les codes que chaque appel peut renvoyer.
Prochaines étapes
Variables d'environnement
Lisez et modifiez les variables d’une application.
Référence de l'API du gestionnaire de fichiers
Les endpoints REST derrière ces méthodes.
Gérer les fichiers depuis la CLI
Les mêmes actions depuis le terminal.

