Runs & Results
Obtenir une exécution
État, progression, erreur, référence upstream, usage et facturation d’une exécution. Prend en charge le long-poll avec wait.
GET
Obtenir une exécution
GET https://api-datahub.octoparse.com/v1/runs/{run_id}
Authentification : clé API requise (Authorization: Bearer <API Key>).
État, progression, objet d’erreur, référence upstream, usage et facturation. Quand wait est supérieur à 0, le serveur maintient la connexion jusqu’à ce que l’exécution atteigne un état terminal ou que l’attente expire. Si ce n’est pas encore terminal, rappelez avec le même wait. Ne sondez pas fréquemment avec wait=0.
Vous ne pouvez lire que les exécutions que vous avez démarrées. Le run_id d’un autre compte et un run_id manquant renvoient tous deux 404.
Requête
Paramètres de chemin
string
requis
Id de l’exécution.
Paramètres de requête
number
défaut:"0"
Secondes maximales d’attente d’un état terminal.
0 (défaut) renvoie le snapshot actuel immédiatement.Plage 0 à 60.Exemple de requête
Réponse
200 succès
data. Champs :
string
requis
—
string
—
string
—
string
—
string
—
string
—
enum
requis
Values:
PENDING / QUEUED / RUNNING / SUCCEEDED / PARTIALLY_SUCCEEDED / FAILED / CANCELLED / EXPIRED.object
—
object
—
string
—
boolean
—
boolean
true tant que l’annulation a été demandée et que l’exécution se termine encore (arrêt coopératif / récupération de résultat partiel). Toujours false en états terminaux (normalisé côté serveur), donc les clients n’ont pas à le dériver de state.string
—
string
—
string
—
string
—
string
Quand un worker a réclamé l’exécution pour la première fois. Contrairement à
started_at, ce n’est jamais réécrit en cas de réessai, donc c’est l’ancre du temps en file : en file = first_started_at - created_at, et temps total mur = finished_at - first_started_at. Dériver le temps en file de started_at compte les tentatives antérieures comme file. null seulement pour les exécutions jamais réclamées.string
—
object
Mesure objective d’usage : ce que l’exécution a fait. Séparée de la facturation ; c’est ce que comparent les évaluations.
object
Grand livre de facturation = usage × tarifs × règles de facturation : combien est facturé.
object
—
object[]
—
object[]
—
Erreurs
Les réponses d’erreur utilisent
{"error": {code, category, message, retryable}}. Voir Erreurs.