Skip to main content
Die Beispiele verwenden den Client api aus Client erstellen. appId ist die ID einer deiner Apps: api.account.me() listet sie auf.

Akzeptierte Eingaben

apps.create() und apps.commit() akzeptieren: In Edge-Runtimes und im Browser übergibst du einen Blob, eine File oder ein Uint8Array: Ein Pfad funktioniert nur dort, wo node:fs existiert. Uploads sind auf 100 MB begrenzt. Eine größere Datei schlägt lokal mit FILE_TOO_LARGE (Status 0) fehl, bevor etwas gesendet wird. Uploads werden gestreamt und haben kein Timeout: Übergib ein signal, um einen abzubrechen.

Eine Anwendung erstellen

apps.create(file) deployt eine .zip, die im Stammverzeichnis eine Konfigurationsdatei squarecloud.app enthält.

Commit in eine Anwendung

apps.commit(appId, file, { path, filename, signal }) lädt eine Datei in eine bestehende App hoch:
  • Eine .zip wird unter path entpackt (standardmäßig im Stammverzeichnis der App).
  • Jede andere Datei landet unter path/<filename>.
Der Dateiname ist filename, sonst der eigene Name der Datei (Pfad oder File), sonst commit.zip.
Ein Commit startet die App nicht neu. Rufe apps.restart() auf, um ihn anzuwenden.

Einen Upload abbrechen

Ein abgebrochener Upload wird mit dem reason des Signals abgelehnt.

Fehler

Ein lokaler Pfad, der sich nicht öffnen lässt, wirft den Dateisystemfehler, keinen SquareCloudAPIError. Die vollständige Liste findest du unter Fehler.

Nächste Schritte

Dateien verwalten

Dateien einer App auflisten, lesen, schreiben, verschieben und löschen.

API-Referenz für Uploads

Die REST-Endpunkte hinter diesen Methoden.

Upload über die CLI

Dieselben Aktionen im Terminal.