Runs & Results
Listar ejecuciones
Lista cada ejecución que iniciaste. Filtra por estado, app, credencial, canal, tipo y rango temporal.
GET
Listar ejecuciones
GET https://api-datahub.octoparse.com/v1/runs
Autenticación: se requiere API key (Authorization: Bearer <API Key>).
Todas las ejecuciones que iniciaste. La propiedad es por cuenta: las iniciadas con API key, SDK, MCP o login web aparecen en la misma lista. Siempre de más reciente a más antigua por hora de inicio. pagination.total es el total filtrado.
Los filtros se pueden combinar. status admite valores separados por comas (OR). credential es el id estable no sensible de la credencial de inicio, útil para ver qué clave consume cuota. created_from / created_to usan la hora de inicio, inicio inclusivo y fin exclusivo. El vocabulario coincide con Agregación de facturación: pasa una clave de grupo de facturación sin cambios para profundizar en las ejecuciones correspondientes.
Cada ítem incluye billing y usage, así que la conciliación por ejecución no necesita una llamada de detalle aparte. La redacción del eco de entrada coincide con el detalle de ejecución.
Solicitud
Parámetros de consulta
string
Estado de la ejecución. Multivalor separado por comas. Valores fuera del vocabulario devuelven
400.string
Id estable de la credencial de inicio. Toma el valor de la agregación de facturación
group_by=credential → credential.string
Referencia de app:
<namespace>/<app_name> o app_<hex>.string
Canal de inicio, por ejemplo
api / sdk / mcp / cli / web.string
Límite inferior de hora de inicio, inclusivo. Marca de tiempo ISO-8601 absoluta.
string
Límite superior de hora de inicio, exclusivo.
string
production para ejecuciones normales; test para debug del autor.Valores: test / production.integer
predeterminado:"0"
Offset de paginación.Rango ≥ 0.
integer
predeterminado:"50"
Tamaño de página, máximo 200.Rango 1 a 200.
Ejemplo de solicitud
Respuesta
200 correcto
data. Campos:
object[]
requerido
Lista de ejecuciones. Cada ítem coincide con los campos de detalle de ejecución (sin
sample_records).object
Objeto de paginación.
Errores
Las respuestas de error usan
{"error": {code, category, message, retryable}}. Véase Errores.