Skip to main content
PUT
Enregistrer le workspace
PUT https://api-datahub.octoparse.com/v1/data-apps/{app_id}/workspace Authentification : clé API requise (Authorization: Bearer <API Key>). Auteur de l’app uniquement ; les autres reçoivent 404. Enregistre le brouillon mutable de l’app. Les enregistrements ne sont jamais rejetés pour échec de validation : la validation complète s’exécute quand même et le résultat (valid / issues) revient dans la réponse. « Sauver un brouillon à moitié et revenir plus tard » est une garantie du modèle. L’identité de l’app est créée implicitement au premier enregistrement — pas d’endpoint séparé « créer l’app ». Utilisez <namespace>/<app_name> au premier save ; ensuite préférez l’app_id stable. expected_revision fournit une concurrence optimiste (409 revision-conflict) pour que plusieurs éditeurs ne se marchent pas dessus. Omettez-le seulement dans les outils mono-écrivain ; les clients interactifs doivent toujours l’envoyer.

Requête

Paramètres de chemin

string
requis
Référence d’app : app_<hex> ou <namespace>/<app_name>. Utilisez la seconde au premier enregistrement.

Corps de la requête

string
requis
Texte brut du manifest.
object
Fichiers joints : clés = chemins relatifs, valeurs = contenu texte.
object
Map de noms de secret vers valeurs en clair. Stocké seulement si cet enregistrement est valide.
integer
Révision courante attendue du brouillon. Écart → 409.

Exemple de requête

Réponse

200 succès

La charge utile est encapsulée dans data. Champs :
string
requis
string
requis
Id d’app stable.
string
integer
requis
Révision du brouillon après enregistrement.
boolean
requis
Si le contenu actuel a passé la validation.
object[]
Liste des problèmes.
string[]
string[]
Noms de secret non stockés car cet enregistrement était invalide.
string

Erreurs

Les réponses d’erreur utilisent {"error": {code, category, message, retryable}}. Voir Erreurs.

Bibliothèques clientes

Les SDK Python et JavaScript n’encapsulent pas encore cet endpoint. Appelez REST directement.