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

Fields match the Démarrer une exécution response. La charge utile est encapsulée dans 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.

Bibliothèques clientes