Runs & Results
Lister les exécutions
Liste chaque exécution que vous avez démarrée. Filtrez par statut, app, credential, canal, type et plage temporelle.
GET
Lister les exécutions
GET https://api-datahub.octoparse.com/v1/runs
Authentification : clé API requise (Authorization: Bearer <API Key>).
Toutes les exécutions que vous avez démarrées. La propriété est par compte : celles démarrées avec une clé API, SDK, MCP ou login web apparaissent dans la même liste. Toujours du plus récent au plus ancien par heure de début. pagination.total est le total filtré.
Les filtres se combinent. status accepte des valeurs séparées par des virgules (OR). credential est l’id stable non sensible de la credential de démarrage, utile pour suivre quelle clé consomme le quota. created_from / created_to utilisent l’heure de début, début inclusif et fin exclusive. Le vocabulaire correspond à Agrégation de facturation : passez une clé de groupe de facturation telle quelle pour détailler les exécutions correspondantes.
Chaque item inclut billing et usage, donc le rapprochement par exécution n’a pas besoin d’un appel de détail séparé. L’expurgation de l’écho d’entrée correspond au détail d’exécution.
Requête
Paramètres de requête
string
État de l’exécution. Multivaleur séparée par des virgules. Les valeurs hors vocabulaire renvoient
400.string
Id stable de la credential de démarrage. Prenez la valeur de l’agrégation de facturation
group_by=credential → credential.string
Référence d’app :
<namespace>/<app_name> ou app_<hex>.string
Canal de démarrage, par exemple
api / sdk / mcp / cli / web.string
Borne inférieure d’heure de début, inclusive. Horodatage ISO-8601 absolu.
string
Borne supérieure d’heure de début, exclusive.
string
production pour les exécutions normales ; test pour le debug de l’auteur.Valeurs : test / production.integer
défaut:"0"
Offset de pagination.Plage ≥ 0.
integer
défaut:"50"
Taille de page, max 200.Plage 1 à 200.
Exemple de requête
Réponse
200 succès
data. Champs :
object[]
requis
Liste d’exécutions. Chaque item correspond aux champs de détail d’exécution (sans
sample_records).object
Objet de pagination.
Erreurs
Les réponses d’erreur utilisent
{"error": {code, category, message, retryable}}. Voir Erreurs.