创建下载任务接口¶
如需下载交易历史记录,您必须先创建下载任务。任务创建成功后,系统将返回一个 download_id。调用交易历史下载 API 时,需要使用该 download_id。
请求¶
参数¶
路径参数¶
| 字段 | 类型 | 描述 |
|---|---|---|
| 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。
请求体示例¶
响应¶
交易记录下载接口将返回一个 ZIP 文件,文件中包含多个 JSON 文件。交易记录按日期进行分组,每一天的数据存储在一个独立的 JSON 文件中。每个文件均包含详细的交易记录,格式如下所示。
响应体¶
| 字段 | 类型 | 描述 |
|---|---|---|
| code | Integer | 响应代码(0 = 成功) |
| message | String | 响应消息 |
| data | String | 任务创建成功后,将返回 download_id。 |
| successful | Boolean | 请求是否成功 |