Publishing
Guardar workspace
Guarda el borrador mutable de la app (workspace). El contenido inválido se puede guardar; la validación vuelve en la respuesta.
PUT
Guardar workspace
PUT https://api-datahub.octoparse.com/v1/data-apps/{app_id}/workspace
Autenticación: se requiere API key (Authorization: Bearer <API Key>). Solo el autor de la app; el resto recibe 404.
Guarda el borrador mutable de la app. Los guardados nunca se rechazan por fallo de validación: la validación completa sigue ejecutándose y el resultado (valid / issues) vuelve en la respuesta. «Guardar un borrador a medias y volver después» es una garantía del modelo.
La identidad de la app se crea de forma implícita en el primer guardado — no hay un endpoint aparte de «crear app». Use <namespace>/<app_name> en el primer save; después prefiera el app_id estable.
expected_revision aporta concurrencia optimista (409 revision-conflict) para que varios editores no se pisen. Omítalo solo en herramientas de un solo escritor; los clientes interactivos deben enviarlo siempre.
Solicitud
Parámetros de ruta
string
requerido
Referencia de app:
app_<hex> o <namespace>/<app_name>. Use la segunda en el primer guardado.Cuerpo de la solicitud
string
requerido
Texto crudo del manifest.
object
Archivos adjuntos: claves = rutas relativas, valores = contenido de texto.
object
Mapa de nombres de secreto a valores en texto plano. Solo se guarda si este save es válido.
integer
Revisión actual esperada del borrador. Si no coincide,
409.Ejemplo de solicitud
Respuesta
200 correcto
data. Campos:
string
requerido
—
string
requerido
Id estable de la app.
string
—
integer
requerido
Revisión del borrador tras guardar.
boolean
requerido
Si el contenido actual pasó la validación.
object[]
Lista de incidencias.
string[]
—
string[]
Nombres de secreto no guardados porque este guardado no fue válido.
string
—
Errores
Las respuestas de error usan
{"error": {code, category, message, retryable}}. Véase Errores.