获取错误文件

GET /api/v1/forward/batches/{batch_id}/error 获取 Batch error.jsonl 的签名下载链接。Batch 必须处于终态。没有符合条件的最终失败任务时不生成 error.jsonl，本接口返回 404 error_file_not_found。

请求头

Header	是否必填	说明
Authorization	是	`Bearer <PAT>`

路径参数

参数	类型	是否必填	说明
batch_id	string	是	Batch ID。

示例请求

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

示例响应

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 获取。

错误码

HTTP	Type	Code	触发条件
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 无效或已过期。

获取错误文件

请求头

路径参数

示例请求

示例响应

下载文件

错误码

相关

获取输出文件

查询 Batch 详情

​请求头

​路径参数

​示例请求

​示例响应

​下载文件

​错误码

​相关

获取输出文件

查询 Batch 详情

请求头

路径参数

示例请求

示例响应

下载文件

错误码

相关