出力ファイルの取得

GET /api/v1/forward/batches/{batch_id}/output output.jsonl の OSS プリサインドダウンロード URL を返します。バッチは終端状態でなければならず、そうでない場合は 400 batch_not_ready を返します。

Headers

Header	Required	Description
`Authorization`	Yes	`Bearer <PAT>`

Path parameters

Parameter	Type	Required	Description
`batch_id`	string	Yes	バッチ ID。

Example request

curl -s -X GET 'https://api.qoder.com/api/v1/forward/batches/batch_completed001/output' \
  -H "Authorization: Bearer $QODER_PAT"

Example response

HTTP 200 OK

{
  "url": "https://cloud-agents-storage.oss-cn-beijing.aliyuncs.com/files%2F<user_id>%2F<file_id>%2Fcontent?Expires=1783685162&OSSAccessKeyId=<ak>&Signature=<sig>&response-content-disposition=attachment%3B%20filename%3Dbatch-batch_completed001-output.jsonl",
  "expires_at": "2026-07-10T12:06:02Z"
}

Response fields

Field	Type	Description
`url`	string	OSS プリサインドダウンロード URL。`Expires` / `OSSAccessKeyId` / `Signature` および `response-content-disposition` を含みます。ダウンロード時のファイル名は `batch-<batch_id>-output.jsonl` です。
`expires_at`	string	リンクの有効期限。RFC 3339。この時刻までにダウンロードを完了する必要があります。

Error codes

HTTP	Type	Code	Trigger
400	`invalid_request_error`	`batch_not_ready`	バッチが終端状態ではありません。
404	`not_found_error`	`batch_not_found`	バッチが存在しない、他ユーザーのもの、または出力ファイルが未生成です。
410	`not_found_error`	`file_expired`	出力ファイルは 30 日保持期間を過ぎて削除されています。
401	`authentication_error`	`authentication_required`	PAT が無効または期限切れです。

Notes

出力ファイルは 30 日間保持されます。保持期間を過ぎると 410 file_expired を返します。
ダウンロードファイル名は batch-<batch_id>-output.jsonl です。
失敗行の結果は error.jsonl に含まれます。バッチ詳細の error_file_id から取得してください。

はじめに

Agent の定義

Agent 環境の設定

Agent にタスクを委任する

Agent コンテキストの管理

ベストプラクティス

API リファレンス

出力ファイルの取得

Headers

Path parameters

Example request

Example response

Response fields

Error codes

Notes

バッチを取得

バッチの一覧取得

​Headers

​Path parameters

​Example request

​Example response

​Response fields

​Error codes

​Notes

​Related

バッチを取得

バッチの一覧取得

Headers

Path parameters

Example request

Example response

Response fields

Error codes

Notes

Related