Publishing
Crear build
Congela el borrador actual en un snapshot inmutable usado para depuración y publicación.
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
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.