Skip to main content
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

La carga útil va envuelta en 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.

Bibliotecas cliente

Los SDK de Python y JavaScript aún no encapsulan este endpoint. Llame a REST directamente.