Runs & Results
Obtener registros de ejecución
Recorre por páginas los registros producidos por una ejecución. Admite JSON, JSONL, CSV y proyección de columnas.
GET
Obtener registros de ejecución
GET https://api-datahub.octoparse.com/v1/runs/{run_id}/records
Autenticación: se requiere API key (Authorization: Bearer <API Key>).
Recorre por páginas los registros producidos por una ejecución. format admite json (por defecto, con sobre y paginación), jsonl y csv. fields es una proyección de columnas separadas por comas.
Puedes leer mientras la ejecución sigue en curso; obtienes lo producido hasta el momento y pagination.total sigue creciendo. Espera un estado terminal para el resultado completo. partial es true cuando la ejecución tuvo éxito parcial o se canceló; esos registros son válidos y ya facturados.
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
integer
predeterminado:"0"
Offset de paginación.Rango ≥ 0.
integer
predeterminado:"100"
Tamaño de página, máximo 10000.Rango 1 a 10000.
string
predeterminado:"json"
Formato de salida.
json va con sobre y paginación; jsonl es un registro por línea; csv es tabular.Valores: json / jsonl / csv.string
Nombres de campos separados por comas. Solo se devuelven estas columnas, por ejemplo
title,price,url.Ejemplo de solicitud
Respuesta
200 correcto
format=jsonl o format=csv, el cuerpo de la respuesta es texto en bruto sin el sobre. Los parámetros de paginación siguen aplicando.
La carga útil va envuelta en data. Campos:
string
Id de la ejecución.
string
requerido
Dataset que contiene el resultado.
object[]
requerido
Array de registros. Cada ítem sigue la forma de
output_schema.record de la app.boolean
Si la ejecución tuvo éxito parcial o se canceló.
object
requerido
Objeto de paginación.
Errores
Las respuestas de error usan
{"error": {code, category, message, retryable}}. Véase Errores.