Publishing
Workspace speichern
Mutablen Draft (Workspace) der App speichern. Ungültiger Inhalt speicherbar; Validierungsergebnis in der Response.
PUT
Workspace speichern
PUT https://api-datahub.octoparse.com/v1/data-apps/{app_id}/workspace
Authentifizierung: API-Schlüssel erforderlich (Authorization: Bearer <API Key>). Nur App-Autor; andere erhalten 404.
Mutablen Draft speichern. Saves nie wegen Validierungsfehlern abgelehnt: volle Validierung läuft, Ergebnis (valid / issues) in der Response. „Halbfertigen Draft speichern und später zurück“ ist Modellgarantie.
Die App-Identität entsteht implizit beim ersten Save — es gibt keinen separaten „create app“-Endpoint. Nur drei Hard-Gates liefern 400: das Konto hat einen Username, der Payload liegt in den Größenlimits, und angehängte Dateinamen sind gültig. identity.app_name im Manifest wird nicht mehr mit dem Pfad verglichen: der Routenname folgt der Referenz, und der in der Datei deklarierte Name wird nur bei der Erstellung verbraucht.
expected_revision bietet optimistische Concurrency (409 revision-conflict), damit Tabs sich nicht still überschreiben. Angehängte Secrets nur bei gültigem Save; nicht gespeicherte Namen in secrets_deferred. Deprecated Apps bleiben editierbar; nur neue Releases werden abgelehnt.
Anfrage
Pfadparameter
string
erforderlich
App-Referenz:
app_<hex> oder <namespace>/<app_name>. Use the latter on first save.Anfrage-Body
string
erforderlich
Roher Manifesttext.
object
Angehängte Dateien: Schlüssel sind relative Pfade, Werte sind Textinhalte.
object
Map von Secret-Namen zu Klartextwerten. Nur gespeichert, wenn dieser Save gültig ist.
integer
Expected current draft revision. Mismatch gibt zurück
409.Beispielanfrage
Antwort
200 Erfolg
data gewrappt. Felder:
string
erforderlich
—
string
erforderlich
Stabile App-ID.
string
—
integer
erforderlich
Draft-Revision nach dem Speichern.
boolean
erforderlich
Ob der aktuelle Inhalt die Validierung bestanden hat.
object[]
Problemliste.
string[]
—
string[]
Secret-Namen nicht gespeichert, weil dieser Save ungültig war.
string
—
Fehler
Fehlerantworten nutzen
{"error": {code, category, message, retryable}}. Siehe Fehler.