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

Los campos coinciden con la respuesta de Iniciar una ejecución. La carga útil va envuelta en data. Campos:
string
requerido
—
string
—
string
—
string
—
string
—
string
—
enum
requerido
Valores: 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.

Bibliotecas cliente