接口描述
接口名:trans_rec_sum_query
请求方法:POST
请求字段:如下表
名称 | 类型 | 必填 | 限制 | 描述 |
version | String | 是 | 1 ≤ length ≤ 8 | 版本号,此版本固定填写“2.0”。 |
sign_type | String | 是 | 0 ≤ length ≤ 8 | 签名算法类型,此版本固定为 “ECDSA”。 |
mch_id | String | 是 | 1 ≤ length ≤ 32 | |
mch_sign | String | 是 | 1 ≤ length ≤ 256 | 通讯方签名结果。 |
chain_id | String | 是 | 1 ≤ length ≤ 32 | 网络 ID。 |
node_id | String | 是 | 1 ≤ length ≤ 32 | 节点 ID。 |
mch_pubkey | String | 是 | 1 ≤ length ≤ 64 | 节点公钥。用户可在 TrustSQL 控制台,节点列表的节点公钥处上传。 |
date | String | 是 | 1 ≤ length ≤ 32 | 查询日期。 |
state | int32 数组 | 是 | value ≥ 0 | 交易状态,当前支持:2. 本地已申请 4. 已提交(转让签收场景下:6. 已签收 7. 已拒签 8. 已撤销)。 |
trans_type | uint64 数组 | 是 | value ≥ 1 | 交易类型,当前支持:1. 发行 2. 转让 3. 兑付 4. 签收。 |
timestamp | String | 是 | 0 ≤ length ≤ 32 | 当前 UNIX 时间戳(秒),与服务器时间相差过远会返回失败。 |
请求示例
{"mch_sign":"MEQCIBAEy8sqQbzc76Yfn91mNZn3V5/vyJoYH4odODNNvx8TAiAtBr0TBaQ4/Atx3DIh+d/+AjbYdEuh1y2XryCmXQM2Sw==","mch_pubkey":"A54sbt2MnFA+w+A6gL3M7o2O7Zq8m2Be7A5vHr1HVoHO","timestamp":"1535951204","trans_type":[1,2],"state":[2,4],"chain_id":"chain_id","node_id": "node_id","mch_id":"mch_id","version":"2.0","sign_type":"ECDSA","date":"2018-08-30"}
应答示例
{"version":"2.0","sign_type":"ECDSA","mch_id":"trust_mch","mch_sign":"MEYCIQDcYSpF2HWrP4MkYTjAmv4Ss8YY3vPx3wJ7k0Cw31UHMgIhALKiKmkwO75eSUKpMQBxkS/s8KC2oB4hNFOwdgBnB/LT","retcode":0,"retmsg":"SUCCESS","date":"2018-08-30","trans_list":[{"trans_type":1,"state":2,"count":10,"dst_amt":49368,"fee_amt":0,"left_amt":0},{"trans_type":2,"state":2,"count":16,"dst_amt":138564,"fee_amt":26,"left_amt":6},{"trans_type":1,"state":4,"count":219,"dst_amt":1101264,"fee_amt":0,"left_amt":0},{"trans_type":2,"state":4,"count":19,"dst_amt":164993,"fee_amt":20,"left_amt":18}],"total":4,"chain_id":"chain_id"}
应答字段解析
名称 | 类型 | 必填 | 限制 | 描述 |
version | String | 是 | 1 ≤ length ≤ 8 | 版本号,此版本固定填写“2.0”。 |
sign_type | String | 是 | 1 ≤ length ≤ 8 | 签名算法类型,此版本固定为 “ECDSA”。 |
mch_id | String | 是 | 1 ≤ length ≤ 32 | |
mch_sign | String | 是 | 1 ≤ length ≤ 256 | 通讯方签名结果。 |
chain_id | String | 是 | 1 ≤ length ≤ 32 | 网络 ID。 |
retcode | int32 | 是 | - | 应答 code,成功时为0。 |
retmsg | String | 是 | - | 应答信息,成功时内容为 SUCCESS。 |
date | String | 否 | 1 ≤ length ≤ 32 | 查询日期。 |
trans_list | message 数组 | 否 | - | 交易信息汇总列表。 |
trans_list.trans_type | int32 | 否 | value ≥ 1 | 交易类型。 |
trans_list.state | int32 | 否 | value ≥ 0 | 交易状态。 |
trans_list.count | int64 | 否 | value ≥ 0 | 交易总笔数。 |
trans_list.amount | int64 | 否 | value ≥ 0 | 交易总额度。 |
trans_list.asset_type | uint64 | 否 | 1 ≤ value ≤ 32 | 资产类型。 |
trans_list.dst_amt | int64 | 否 | value ≥ 0 | 交易总额度。 |
trans_list.fee_amt | int64 | 否 | value ≥ 0 | 交易总额度。 |
trans_list.left_amt | int64 | 否 | value ≥ 0 | 交易总额度。 |
total | int32 | 否 | value ≥ 0 | 交易数量。 |