Skip to main content
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

I campi corrispondono alla risposta di Start a run. Il payload è wrappato in 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.

Librerie client