Skip to main content
POST
Crear build
POST https://api-datahub.octoparse.com/v1/data-apps/{app_id}/builds Autenticación: se requiere API key (Authorization: Bearer <API Key>). Solo el autor de la app; el resto recibe 404. Congela el workspace actual en un snapshot inmutable — el objeto referenciado por depuración y publicación. Precondiciones: debe existir un workspace y su contenido actual debe ser válido (si no, 422 con issues); el cuerpo puede incluir expected_revision (409 si el borrador cambió entre save y freeze). Si ya existe un snapshot ready con el mismo content_hash, se reutiliza y no se crea fila duplicada. Los builds tipo api quedan ready de inmediato; tipo código devuelve 202 y encola un build de imagen — volver a enviar mientras ya hay uno en curso para la misma app devuelve 409. Las apps deprecadas aún pueden hacer build; solo se rechazan Releases nuevas.

Solicitud

Parámetros de ruta

string
requerido
Referencia de app.

Cuerpo de la solicitud

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
Id del build.
string
requerido
ready, building (tipo código) o failed.
string
requerido
Hash de contenido.
integer
requerido
Revisión del borrador al congelar.
boolean
Si se reutilizó un snapshot existente con el mismo contenido.
string
Hora de creación.

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.