Publishing
Enregistrer le workspace
Enregistrer le brouillon mutable de l’app (workspace). Le contenu invalide peut être sauvé ; la validation revient dans la réponse.
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
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.