跳转至

创建下载任务接口

如需下载交易历史记录,您必须先创建下载任务。任务创建成功后,系统将返回一个 download_id。调用交易历史下载 API 时,需要使用该 download_id。

请求

POST https://api.mycactus.dev/custody-download/v1/api/projects/{b_id}/tx-details/download
request
POST https://api.mycactus.com/custody-download/v1/api/projects/{b_id}/tx-details/download
request

参数

路径参数

字段类型描述
b_id
必填
String业务线ID

请求体参数

字段类型描述
start_date
必填
String交易查询时间范围的开始日期。
格式:YYYY-MM-DD
end_date
必填
String交易查询时间范围的截止日期。
格式:YYYY-MM-DD
download_id
可选
String下载任务 ID。如果请求体中未提供该参数,系统将自动生成下载 ID。必须符合正则表达式 ^[A-Za-z0-9_-]+$。

start_date 与 end_date 参数之间的时间跨度不得超过 10 天。若日期范围超过 10 天,API 将返回错误码 10380002。\ \ 如果提供的 download_id 不符合上述正则表达式,API 将返回错误码 10380002。

请求体示例

{
   "start_date":"2025-12-02",
   "end_date":"2025-12-04"
}

响应

交易记录下载接口将返回一个 ZIP 文件,文件中包含多个 JSON 文件。交易记录按日期进行分组,每一天的数据存储在一个独立的 JSON 文件中。每个文件均包含详细的交易记录,格式如下所示。

响应体

字段类型描述
codeInteger响应代码(0 = 成功)
messageString响应消息
dataString任务创建成功后,将返回 download_id。
successfulBoolean请求是否成功

响应示例

{
   "code": 0,
   "message": "",
   "data": "b1447047670845f1",
   "successful": true
}