生成对账单下载链接
2020-02-11 06:12:49
admin
4
接口介绍
本接口用于生成 商户对账单 的下载链接，由于对账单生成需要一定的时间（时间不固定，一般10分钟以内），所以在本接口会返回一个对账单下载链接的查询token，然后通过接口 对账单生成进度查询 来查询对账单生成的进度。
生成的对账单格式为csv，具体介绍请参见：对账单生成进度查询
注： 生成的下载链接一周内有效，可以重复下载， 超过一周需要重新生成。
参数简介
公共参数
| 参数名 | 参数类型 | 参数介绍 | 是否必填 |
|---|---|---|---|
| command | String(32) | 接口名，固定为：open.api.download.csv | 是 |
| app | String(32) | 接入商标识 | 是 |
| operator_id | String(32) | 收银员的id，用于标识收款账户 | 是 |
| version | String(16) | 调用的接口版本，固定为：2.0 | 是 |
| sign_type | String(32) | 签名类型 MD5、RSA，默认MD5 | 否 |
| request_id | String(64) | 请求报文ID，唯一定位一次报文请求，由发起方生成，应答方原样返回，uuid生成，全局唯一 | 是 |
| request_time | String(32) | 请求发起时间，格式：yyyyMMddHHmmss，请求发起时间，应答方原样返回 | 是 |
| sign | String | 签名，详见MD5签名、RSA256签名 | 是 |
参数简介
| 参数名 | 参数类型 | 参数介绍 | 是否必填 |
|---|---|---|---|
| start_date | String(16) | 开始时间，格式:yyyy-MM-dd，最多填入1年内的一个日期（即今天与start_date之间最多不能超过365） | 是 |
| end_date | String(16) | 开始时间，格式:yyyy-MM-dd，大于start_date, 并且相差不能超过31天 | 是 |
返回值说明
公共返回值
| 参数名 | 所属结构 | 返回值类型 | 返回值说明 | 特殊备注 |
|---|---|---|---|---|
| success | result | boolean | 标识这次请求是否成功 | |
| error_code | result | String | 错误码 | |
| error_msg | result | String | 错误码的详细说明 | |
| request_id | data | String(64) | 请求报文ID | |
| request_time | data | String(32) | 请求发起时间，格式：yyyyMMddHHmmss | |
| response_time | data | String(32) | 请求返回时间，格式：yyyyMMddHHmmss | |
| sign | sign | String | 签名值 | 具体参照: 接口验签规则 |
数据返回值
| 参数名 | 所属结构 | 返回值类型 | 返回值说明 | 特殊备注 |
|---|---|---|---|---|
| token | data | String(32) | 用于查询生成进度的token | 参与签名 |
返回值举例
{
"data": {
"request_id": "4eaf2b39-d91a-443a-8445-379712d85816",
"request_time": "20180926164558",
"response_time": "20180926164846",
"token": "9230"
},
"result": {
"success": true
},
"sign": "LSAB33dR6iYCf5Qn9w4MvUokSwR1ZYgmbYZAQ4pLQSfwYTquyyqwEzkZ6ZPV07JT+F4hudAFigRPYxdod/SBjMkdIn20cTn5HaOGiQ2UopemBZzn9mbakjBvJOdWGTxUkTEbV21tTOu9naxqtAQZ0c9P82iJXcj23FN5SOB9uM1Sk0RBhH7yvXhdQuKSFH+HefCR9ushDGiN+JE2WhdqW5Km/scifNPamWh9RLaXAMUpDFhdP9VoC7s0Tsy5dx0YNHIY0zwgbbXVl4v91Nb7OBuNOlhpvzvjwnT1kXh0cKDGiZ39KFjy+92JGCuOOjU7v1kchquqLb408BvGmyGPpQ=="
}Js Demo
http://openapi.qiantupay.net/test/api/v2/downloadCsv.htm