Skip to main content
GET
実行を取得
GET https://api-datahub.octoparse.com/v1/runs/{run_id} 認証:APIキー必須(Authorization: Bearer <API Key>)。 状態、進捗、エラーオブジェクト、上流参照、使用量、課金。wait が 0 超なら終端到達または wait 経過まで接続保持(long-poll)。 自分が開始した実行のみ読める。他アカウントの run_id と存在しない run_id はどちらも 404。 入力の sensitive フィールドはエコーで伏字。

リクエスト

パスパラメータ

string
必須
実行 id。

クエリパラメータ

number
デフォルト:"0"
long-poll 秒。0–60。既定 0 は即時。範囲 0〜60。

リクエスト例

レスポンス

200 成功

フィールドは 実行を開始 の応答と同じ。 ペイロードは data に包まれます。フィールド:
string
必須
string
string
string
string
string
enum
必須
値: PENDING / QUEUED / RUNNING / SUCCEEDED / PARTIALLY_SUCCEEDED / FAILED / CANCELLED / EXPIRED
object
object
string
boolean
boolean
取消要求済みで収束中なら true(協調停止/部分結果回収)。終端では常に false(サーバ正規化)。state から導出不要。
string
string
string
string
string
ワーカーが初めて実行を引き受けた時刻。started_at と違いリトライで上書きされないため壁時計の基準: queued = first_started_at - created_at、総壁時間 = finished_at - first_started_atstarted_at から queued を取ると以前の試行を待ちと誤算。未割当のみ null
string
object
客観使用量: 実行が何をしたか。課金と分離。評価比較の基準。
object
課金台帳 = 使用量 × 料金 × 課金ルール。
object
object[]
object[]

エラー

エラー応答は {"error": {code, category, message, retryable}} です。エラー を参照。

クライアントライブラリ