Skip to main content
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.

Entrées acceptées

apps.create() et apps.commit() acceptent : Sur les runtimes edge et dans le navigateur, passez un Blob, un File ou un Uint8Array : un chemin ne fonctionne que là où node:fs existe. Les envois sont limités à 100 Mo. Un fichier plus volumineux échoue localement avec FILE_TOO_LARGE (statut 0) avant tout envoi. Les envois sont diffusés en flux et n’ont aucun timeout : passez un signal pour en annuler un.

Créer une application

apps.create(file) déploie un .zip qui contient un fichier de configuration squarecloud.app à sa racine.

Faire un commit sur une application

apps.commit(appId, file, { path, filename, signal }) envoie un fichier dans une application existante :
  • Un .zip est décompressé dans path (la racine de l’application par défaut).
  • Tout autre fichier est placé dans path/<filename>.
Le nom du fichier est filename, à défaut le nom propre du fichier (chemin ou File), à défaut commit.zip.
Un commit ne redémarre pas l’application. Appelez apps.restart() pour l’appliquer.

Annuler un envoi

Un envoi annulé est rejeté avec la reason du signal.

Erreurs

Un chemin local qui ne peut pas être ouvert lève l’erreur du système de fichiers, et non une SquareCloudAPIError. Voir Erreurs pour la liste complète.

Prochaines étapes

Gérer les fichiers

Listez, lisez, écrivez, déplacez et supprimez les fichiers d’une application.

Référence de l'API d'envoi

Les endpoints REST derrière ces méthodes.

Envoyer depuis la CLI

Les mêmes actions depuis le terminal.