接口描述
接口名:trans_rec_detail_query
请求方法:POST
请求字段:如下表
名称 | 类型 | 必填 | 限制 | 描述 |
---|---|---|---|---|
version | String | 是 | 1 ≤ length ≤ 8 | 版本号,此版本固定填写“2.0”。 |
sign_type | String | 是 | 0 ≤ length ≤ 8 | 签名算法类型,此版本固定为 “ECDSA”。 |
mch_id | String | 是 | 1 ≤ length ≤ 32 | 通讯方的 ID。腾讯云账号的 APPID,可从 账号信息 页面获取。 |
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 | 查询日期。 |
asset_type | uint64 数组 | 是 | value ≥ 1 | 资产类型,例如:0. 商票 1. 数字货币 2. Q币 3. 游戏装备 4. 黄金 5. 积分 6. 卡券 7. 股权。 |
trans_type | int32 数组 | 是 | value ≥ 1 | 交易类型,当前支持: 1. 发行 2. 转让 3. 兑付 4. 签收。 |
state | int32 数组 | 是 | value ≥ 1 | 交易状态,当前支持: 2. 本地已申请 4. 已提交 (转让签收场景下:6. 已签收 7. 已拒签 8. 已撤销)。 |
page_limit | int32 | 是 | 0 ≤ value ≤ 20 | 查询条数。 |
page_no | int32 | 是 | value ≥ 1 | 页数。 |
timestamp | String | 是 | length ≥ 0 | 当前 UNIX 时间戳(秒),与服务器时间相差过远会返回失败。 |
请求示例
{
"mch_sign": "MEQCIAxrEMfJjRvxTrceK51hnpAr8quHQNnXN2PbZVlg9q/nAiBzlBmWwHlhZi+IRlJzFwmk4xFFRIQD8qKf4e1Cq7vPwA==",
"version": "2.0",
"mch_pubkey": "A54sbt2MnFA+w+A6gL3M7o2O7Zq8m2Be7A5vHr1HVoHO",
"timestamp": "1545029614",
"trans_type": [
1,
2
],
"chain_id": "chain_id",
"node_id": "node_id",
"page_limit": 20,
"mch_id": "mch_id",
"state": [
4
],
"sign_type": "ECDSA",
"date": "2018-12-17",
"asset_type": [
1
],
"page_no": 10
}
应答示例
{
"version":"2.0",
"sign_type":"ECDSA",
"mch_id":"trust_mch",
"mch_sign":"MEYCIQC8oSpQck3a3Sv+Q7klyoBJdgZYZqZEoCP4Y6A8/yDqSAIhAN+Bu1SAsyV/CCpuL8NjUGy4tmRygn1HLxQ5Nf5SCGzU",
"retcode":0,
"retmsg":"SUCCESS",
"date":"2018-12-17",
"trans_list":[
],
"total":18,
"chain_id":"chain_id",
"mch_pubkey":"AjOZgNdnh6y0pH7yYyFts2xUm13wTd6upr/6jXjiHiVW"
}
应答字段解析
名称 | 类型 | 必填 | 限制 | 描述 |
---|---|---|---|---|
version | String | 是 | 1 ≤ length ≤ 8 | 版本号,此版本固定填写“2.0”。 |
sign_type | String | 是 | 1 ≤ length ≤ 8 | 签名算法类型,此版本固定为 “ECDSA”。 |
mch_id | String | 是 | 1 ≤ length ≤ 32 | 通讯方的 ID。腾讯云账号的 APPID,可从 账号信息 页面获取。 |
chain_id | String | 否 | 1 ≤ length ≤ 32 | 网络 ID。 |
mch_sign | String | 是 | 1 ≤ length ≤ 256 | 通讯方签名结果。 |
retcode | int32 | 是 | - | 应答 code,成功时为0。 |
retmsg | String | 是 | - | 应答信息,成功时内容为 SUCCESS。 |
date | String | 否 | 1 ≤ length ≤ 32 | 查询日期。 |
trans_list | message 数组 | 否 | - | 用户资产信息。 |
trans_list.trans_hash | String | 否 | 0 ≤ length ≤ 64 | 区块链交易 Fhash 值。 |
trans_list.transaction_id | String | 否 | 1 ≤ length ≤ 32 | 交易 ID。 |
trans_list.trans_type | int32 | 否 | value ≥ 1 | 交易类型。 |
trans_list.trans_state | int32 | 否 | value ≥ 1 | 交易状态。 |
trans_list.src_account | String | 否 | 0 ≤ length ≤ 64 | 资产转出账户。 |
trans_list.dst_account | String | 否 | 0 ≤ length ≤ 64 | 资产转入账户。 |
trans_list.src_asset_list | String | 否 | 1 ≤ length ≤ 64 | 资产转出的 ID 列表。 |
trans_list.dst_asset_id | String | 否 | 1 ≤ length ≤ 64 | 资产转入的 ID。 |
trans_list.left_asset_id | String | 否 | 1 ≤ length ≤ 64 | 剩余找零资产 ID。 |
trans_list.dst_amount | uint64 | 否 | value ≥ 1 | 转出到目标账户的资产份额。 |
trans_list.left_amount | uint64 | 否 | value ≥ 1 | 剩余的资产份额。 |
trans_list.fee_amount | uint64 | 否 | value ≥ 1 | 手续费份额。 |
trans_list.extra_info | String | 否 | - | 扩展信息。 |
trans_list.sign_str_list | String | 否 | - | 当状态为2/3时,表示 JSON String 格式待签名串。 |
trans_list.b_height | int64 | 否 | value ≥ 0 | 交易所在的区块的高度。 |
trans_list.b_time | String | 否 | length ≥ 0 | 交易所在的区块的创建时间。 |
trans_list.business | int64 | 否 | - | 业务类型。 |
total | int32 | 否 | value ≥ 0 | 交易数量。 |
mch_pubkey | String | 是 | 1 ≤ length ≤ 64 | 通讯方公钥(支持1.2以上版本)。 |