Runs & Results
Elenca esecuzioni
Elenca ogni esecuzione avviata da te. Filtra per stato, app, credenziale, canale, kind e intervallo di tempo.
GET
Elenca esecuzioni
GET https://api-datahub.octoparse.com/v1/runs
Autenticazione: API key obbligatoria (Authorization: Bearer <API Key>).
Tutti i run che hai avviato. La proprietà è per account: i run avviati con API key, SDK, MCP o accesso web compaiono nella stessa lista. Sempre dal più recente per ora di avvio. pagination.total è il totale filtrato.
I filtri si possono combinare. status accetta valori separati da virgola (OR). credential è l’id stabile non sensibile della credenziale di avvio, utile per tracciare quale key consuma quota. created_from / created_to usano l’ora di start, inizio inclusivo e fine esclusiva. Il vocabolario allinea Aggregazione fatturazione: passa invariata una group key di billing per fare drill-down sulle run corrispondenti.
Ogni elemento include billing e usage, quindi la riconciliazione per singolo run non richiede una chiamata di dettaglio separata. L’oscuramento dell’eco dell’input corrisponde a quello del dettaglio del run.
Richiesta
Parametri di query
string
Stato del run. Valori multipli separati da virgole. I valori fuori dal vocabolario restituiscono
400.string
ID stabile della credenziale di avvio. Prendi il valore dall’aggregazione della fatturazione
group_by=credential → credential.string
Riferimento all’app:
<namespace>/<app_name> o app_<hex>.string
Start channel, ad esempio
api / sdk / mcp / cli / web.string
Limite inferiore dell’ora di avvio, incluso. Timestamp assoluto ISO-8601.
string
Bound superiore start-time, esclusivo.
string
production per run normali; test per run di debug dell’autore.Valori: test / production.integer
predefinito:"0"
Offset di paginazione.Intervallo ≥ 0.
integer
predefinito:"50"
Dimensione pagina, max 200.Intervallo da 1 a 200.
Esempio di richiesta
Risposta
200 successo
data. Campi:
object[]
obbligatorio
Elenco dei run. Ogni elemento corrisponde ai campi del dettaglio del run (senza
sample_records).object
Oggetto di paginazione.
Errori
Le risposte di errore usano
{"error": {code, category, message, retryable}}. Vedi Errori.