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

Payload ist in 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.

Client-Bibliotheken