Thunderbit Open API home page
サポートAPIコンソール
Distill

バッチディスティルジョブのステータス取得

GET
/batch/distill/{id}
バッチディスティルジョブのステータス取得

バッチディスティルジョブのステータスを確認し、結果を取得します。

レスポンスの状態:

  • processing: ジョブが現在実行中
  • completed: すべてのURLの処理が完了
  • failed: ジョブで致命的なエラーが発生

ポーリングのベストプラクティス:

  • 10件未満のURLのジョブでは5〜10秒ごとにポーリング
  • より大きなジョブでは30〜60秒ごとにポーリング
  • 効率化のためにWebhookを使用

部分的な結果: ジョブの処理中でも、完了した結果を取得できます。results配列には、これまでに処理されたすべてのURLが含まれます。

認証

YOUR_API_KEY
認証Bearer <token>

Thunderbit Dashboard から API キーを取得してください。ヘッダー形式：Authorization: Bearer YOUR_API_KEY

位置: header

パスパラメータ

id*string必須

バッチタスクID

クエリパラメータ

pageintegerデフォルト：0

Page number (0-based), default 0

範囲：0 <= x
pageSizeintegerデフォルト：20

Number of results per page (1-100), default 20

範囲：1 <= x <= 100

レスポンス

application/json

Success response

successboolean
例：
true
dataobject
子属性を表示
idstring
例：batch_abc123
statusstring
値"PENDING" | "PROCESSING" | "COMPLETED" | "FAILED" | "CANCELLED" | "UNKNOWN"
例：COMPLETED
totalinteger
例：
3
completedinteger
例：
2
failedinteger

Number of failed URLs

例：
1
creditsUsedinteger
例：
2
createdAtstring

Timestamp when the job was created

completedAtstring

Timestamp when the job completed (null if still processing)

resultsobject[]
子属性を表示
indexinteger

Zero-based index of this URL in the original batch

例：
0
urlstring

The processed URL

statusstring

Per-URL processing status: PENDING, PROCESSING, SUCCEEDED, or FAILED

値"PENDING" | "PROCESSING" | "SUCCEEDED" | "FAILED"
例：SUCCEEDED
markdownstring

Extracted markdown content (present when status is SUCCEEDED)

errorobject

Error detail (present when status is FAILED)

子属性を表示
codestring
例：DISTILL_FAILED
messagestring
例：Failed to fetch the page: Connection timeout

ページネーション

  • pageSize のデフォルトは 20、1 リクエストの上限は 100。1 回で最大件数を取得するには pageSize=100 を指定します。
  • 合計が 100 を超える場合は、page（0 始まり）を results が空になるまでインクリメントします：page=0、page=1 …。
  • レスポンス中の total は、そのバッチの結果総数を示します。

目次

ページネーション