エラーファイルを取得

GET /api/v1/forward/batches/{batch_id}/error Batch の error.jsonl に対する署名付きダウンロード URL を取得します。Batch は終端状態である必要があります。最終的に失敗した対象タスクがない場合、error.jsonl は生成されず、このエンドポイントは 404 error_file_not_found を返します。

Headers

Header	Required	Description
`Authorization`	Yes	`Bearer <PAT または SAT>`

Path parameters

Parameter	Type	Required	Description
`batch_id`	string	Yes	Batch ID。

Example request

curl -s -X GET 'https://api.qoder.com/api/v1/forward/batches/batch_failed001/error' \
  -H "Authorization: Bearer $QODER_ACCESS_TOKEN"

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_failed001-error.jsonl",
  "expires_at": "2026-07-10T12:06:02Z"
}

ファイルをダウンロード

error_url="$(
  curl -fsS \
    "${FORWARD_BASE_URL}/api/v1/forward/batches/${BATCH_ID}/error" \
    -H "Authorization: Bearer ${QODER_ACCESS_TOKEN}" \
  | jq -er '.url'
)"

curl -fL \
  --output "batch-${BATCH_ID}-error.jsonl" \
  "${error_url}"
unset error_url

署名付き URL には一時的なアクセス認証情報が含まれます。この URL を表示、記録、またはコミットしないでください。また、set -x を有効にした状態で上記のコマンドを実行しないでください。 Batch が生成する output_file_id / error_file_id は内部結果ファイルの識別子です。Forward の汎用ファイルリソースとして登録されないため、/api/v1/forward/files/{file_id} または /content から取得できません。

Error codes

HTTP	Type	Code	Trigger
400	`invalid_request_error`	`batch_not_ready`	Batch が終端状態ではありません。
404	`not_found_error`	`batch_not_found`	Batch が存在しない、または他のユーザーに属しています。
404	`not_found_error`	`error_file_not_found`	Batch が `error.jsonl` を生成していません。
410	`not_found_error`	`file_expired`	エラーファイルは 30 日の保持期間を過ぎて削除されています。
401	`authentication_error`	`authentication_required`	PAT または SAT が無効または期限切れです。

エラーファイルを取得

Headers

Path parameters

Example request

Example response

ファイルをダウンロード

Error codes

出力ファイルを取得

Batch を取得

​Headers

​Path parameters

​Example request

​Example response

​ファイルをダウンロード

​Error codes

​Related

出力ファイルを取得

Batch を取得

Headers

Path parameters

Example request

Example response

ファイルをダウンロード

Error codes

Related