Skip to main content
PUT
Datei erstellen/ändern
string
erforderlich
Der API-Schlüssel für Ihr Konto. Sie finden ihn in Ihren Kontoeinstellungen.
Datei erstellen/ändern schreibt content nach path innerhalb einer laufenden Anwendung, erstellt die Datei, falls sie nicht existiert, oder überschreibt sie, falls doch. content akzeptiert entweder eine UTF-8-Zeichenkette für Textdateien oder ein Byte-Array { type: "Buffer", data: number[] } für Binärinhalte. Nutze es für kleine, gezielte Änderungen, etwa das Anpassen eines Konfigurationswerts oder das Ablegen einer generierten Datei, ohne die gesamte Anwendung neu hochzuladen; für Massenänderungen oder eine .zip-Datei nutze stattdessen Anwendung committen. Ein Schreibvorgang auf squarecloud.app oder squarecloud.config wird besonders behandelt: Die Plattform parst die Datei als Konfiguration der Anwendung (Anzeigename, Beschreibung, Speicher, Autorestart, Subdomain) und validiert jedes Feld; ein ungültiger Wert liefert einen spezifischen Fehlercode (zum Beispiel INVALID_MEMORY oder INVALID_SUBDOMAIN) statt die Datei zu schreiben. Diese Konfigurationsänderungen sind auf 1 Anfrage alle 15 Sekunden pro Benutzer begrenzt. Bei Workspace-geteilten Anwendungen benötigt der Aufrufer die Rolle Maintainer oder Administrator, und Mitglieder ohne die Berechtigung für eingeschränkte Dateien dürfen nicht in ausgeschlossene Pfade wie .env schreiben. Wie andere Dateimanager-Routen startet auch dieser Endpunkt die Anwendung nicht neu, rufe Anwendung neu starten auf, um Änderungen anzuwenden, die einen frischen Prozess benötigen.

Parameter

string
erforderlich
Die ID der Anwendung. Du findest sie in der URL des Dashboards deiner Anwendung.
string
erforderlich
Der Pfad, unter dem die Datei erstellt werden soll. Beispiel: /test.txt
string
erforderlich
Der Inhalt der zu erstellenden Datei.

Antwort

string
Gibt an, ob der Aufruf erfolgreich war. success bei Erfolg, error andernfalls.

Häufige Fehler