Runs & Results
Runs auflisten
Alle selbst gestarteten Runs auflisten. Filter nach Status, App, Credential, Kanal, Kind und Zeitraum.
GET
Runs auflisten
GET https://api-datahub.octoparse.com/v1/runs
Authentifizierung: API-Schlüssel erforderlich (Authorization: Bearer <API Key>).
Alle von Ihnen gestarteten Runs. Die Zuordnung erfolgt über das Konto: Runs, die per API-Schlüssel, SDK, MCP oder Web-Login gestartet wurden, erscheinen in derselben Liste. Immer nach Startzeit sortiert, neueste zuerst. pagination.total ist die gefilterte Gesamtzahl.
Filter sind kombinierbar. status akzeptiert kommagetrennte Werte (OR). credential ist die nicht-sensitive stabile ID der startenden Credential, nützlich um zu tracken welcher Key Quota verbraucht. created_from / created_to nutzen die Startzeit, Start inklusiv und Ende exklusiv. Das Vokabular entspricht Abrechnungsaggregation: einen Billing-Gruppenkey unverändert durchreichen, um in die passenden Runs zu drill-downen.
Jeder Eintrag enthält billing und usage, sodass für den Abgleich pro Run kein separater Detailaufruf nötig ist. Die Schwärzung des Input-Echos entspricht dem Run-Detail.
Anfrage
Abfrageparameter
string
Run-Status. Kommagetrennte Mehrfachwerte. Werte außerhalb des Vokabulars liefern
400.string
Stabile ID der startenden Credential. Übernehmen Sie den Wert aus der Abrechnungsaggregation
group_by=credential → credential.string
App-Referenz:
<namespace>/<app_name> oder app_<hex>.string
Start channel, z. B.
api / sdk / mcp / cli / web.string
Untere Grenze der Startzeit, inklusiv. Absoluter ISO-8601-Zeitstempel.
string
Startzeit-Obergrenze, exklusiv.
string
production für normale Runs; test für Autor-Debug-Runs.Werte: test / production.integer
Standard:"0"
Paginierungs-Offset.Bereich ≥ 0.
integer
Standard:"50"
Seitengröße, max 200.Bereich 1 bis 200.
Beispielanfrage
Antwort
200 Erfolg
data gewrappt. Felder:
object[]
erforderlich
Run-Liste. Jeder Eintrag entspricht den Feldern des Run-Details (ohne
sample_records).object
Paginierungsobjekt.
Fehler
Fehlerantworten nutzen
{"error": {code, category, message, retryable}}. Siehe Fehler.