下载报告

接口概述

按指定格式获取任务的报告文件地址，支持一次请求多种报告格式。

请求地址

POST /loadDownReport

请求头

参数	必填	说明
apiKey	是	API 访问凭证
Platform	是	平台标识，取值参见快速开始
Content-Type	是	application/json

请求参数

参数	类型	必填	说明
taskId	String	是	任务 ID
reportFormatList	Array	是	报告格式列表，取值参见报告格式，如 ["WORD"]、["PDF"]

请求示例

curl -X POST "https://openapi.bangtu-ai.com/openApi/loadDownReport" \
  -H "apiKey: YOUR_API_KEY" \
  -H "Platform: INSPECTOR" \
  -H "Content-Type: application/json" \
  -d '{
    "taskId": "1900789012345678901",
    "reportFormatList": ["WORD", "PDF"]
  }'

返回结果

{
  "code": 200,
  "message": "success",
  "data": "openApi/report/1900789012345678901.docx",
  "timestamp": 1784533680000
}

返回字段

字段	类型	说明
code	Number	通用响应码，200 表示成功
message	String	响应信息
data	String | null	报告文件地址
timestamp	Number	服务端响应时间戳，单位为毫秒

响应码

code	说明
200	请求成功
500	请求失败，具体原因见 message

注意事项

• taskId 与 reportFormatList 均为必填，缺失时返回参数校验失败。
• 报告下载次数会计入任务的 downloadNum 字段。
• 返回的文件地址需配合文件下载接口获取文件流。
• 若报告被锁定，需先调用发布报告或生成报告解锁。