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

Fields match the Iniciar una ejecución response. La carga útil va envuelta en 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.

Bibliotecas cliente