Runs & Results
Ottieni un’esecuzione
Leggi stato, progresso, errore, usage e fatturazione dell’esecuzione. Supporta long polling.
GET
Ottieni un’esecuzione
GET https://api-datahub.octoparse.com/v1/runs/{run_id}
Autenticazione: API key obbligatoria (Authorization: Bearer <API Key>).
Stato, progresso, oggetto errore, riferimento upstream, usage e fatturazione. Con wait > 0 il server tiene la connessione fino a stato terminale o timeout. Se non è ancora terminale, richiama con lo stesso wait. Non fare poll frequenti con wait=0.
Puoi leggere solo le run che hai avviato. Il run_id di un altro account e un run_id mancante restituiscono entrambi 404. I campi marcati sensitive nel contratto di input sono redatti in echo: plaintext write-only che nemmeno lo starter può rileggere.
Richiesta
Parametri di percorso
string
obbligatorio
ID del run.
Parametri di query
number
predefinito:"0"
Long-poll seconds,
0–60. Predefinito 0 restituisce immediately.Intervallo da 0 a 60.Esempio di richiesta
Risposta
200 successo
data. Campi:
string
obbligatorio
—
string
—
string
—
string
—
string
—
string
—
enum
obbligatorio
Valori:
PENDING / QUEUED / RUNNING / SUCCEEDED / PARTIALLY_SUCCEEDED / FAILED / CANCELLED / EXPIRED.object
—
object
—
string
—
boolean
—
boolean
true mentre l’annullamento è stato richiesto e il run è ancora in fase di chiusura (arresto cooperativo / recupero dei risultati parziali). Sempre false negli stati terminali (normalizzato lato server), quindi i client non devono ricavarlo da state.string
—
string
—
string
—
string
—
string
Quando un worker ha claimato la run la prima volta. A differenza di
started_at non viene mai riscritto al retry: ancora per il tempo in coda: queued = first_started_at - created_at, wall time totale = finished_at - first_started_at. Derivare il tempo in coda da started_at conta i tentativi precedenti come queueing. null solo per run mai claimate.string
—
object
Metering usage oggettivo: quanto ha fatto la run. Separato dalla fatturazione; è ciò che le evaluation confrontano.
object
Registro di fatturazione = utilizzo × prezzi × regole di fatturazione: quanto viene addebitato.
object
—
object[]
—
object[]
—
Errori
Le risposte di errore usano
{"error": {code, category, message, retryable}}. Vedi Errori.