Runs & Results
Obtener una ejecución
Estado, progreso, error, referencia upstream, uso y facturación de una ejecución. Admite long-poll con wait.
GET
Obtener una ejecución
GET https://api-datahub.octoparse.com/v1/runs/{run_id}
Autenticación: se requiere API key (Authorization: Bearer <API Key>).
Estado, progreso, objeto de error, referencia upstream, uso y facturación. Cuando wait es mayor que 0, el servidor mantiene la conexión hasta que la ejecución alcanza un estado terminal o se agota la espera. Si aún no es terminal, vuelve a llamar con el mismo wait. No hagas sondeo frecuente con wait=0.
Solo puedes leer ejecuciones que iniciaste. El run_id de otra cuenta y un run_id inexistente devuelven 404.
Solicitud
Parámetros de ruta
string
requerido
Id de la ejecución.
Parámetros de consulta
number
predeterminado:"0"
Segundos máximos de espera de un estado terminal.
0 (por defecto) devuelve el snapshot actual de inmediato.Rango 0 a 60.Ejemplo de solicitud
Respuesta
200 correcto
data. Campos:
string
requerido
—
string
—
string
—
string
—
string
—
string
—
enum
requerido
Values:
PENDING / QUEUED / RUNNING / SUCCEEDED / PARTIALLY_SUCCEEDED / FAILED / CANCELLED / EXPIRED.object
—
object
—
string
—
boolean
—
boolean
true mientras se ha solicitado la cancelación y la ejecución aún se está deteniendo (parada cooperativa / recuperación de resultado parcial). Siempre false en estados terminales (normalizado en el servidor), así que los clientes no necesitan derivarlo de state.string
—
string
—
string
—
string
—
string
Cuando un worker reclamó la ejecución por primera vez. A diferencia de
started_at, no se reescribe en reintentos, así que es el ancla del tiempo en cola: en cola = first_started_at - created_at, y tiempo total de pared = finished_at - first_started_at. Derivar el tiempo en cola de started_at cuenta intentos anteriores como cola. null solo en ejecuciones nunca reclamadas.string
—
object
Medición objetiva de uso: cuánto hizo la ejecución. Separada de la facturación; es lo que comparan las evaluaciones.
object
Libro de facturación = uso × precios × reglas de facturación: cuánto se cobra.
object
—
object[]
—
object[]
—
Errores
Las respuestas de error usan
{"error": {code, category, message, retryable}}. Véase Errores.