Skip to main content
Le gestionnaire de fichiers se trouve sur 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 string est envoyée en texte brut.
  • Un Uint8Array est envoyé en base64, de sorte que tout contenu binaire est conservé à l’identique.
  • Un contenu vide ("" ou octets vides) crée un fichier vide.
Un contenu de plus de 10 Mo échoue localement avec 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.