资产明细对账
请求地址:http://{node_ip:node_port}/asset_rec_detail_query (node_ip:节点的内网/外网ip, node_port:15910)
请求方法:POST
请求字段:
名称 类型 必填 限制 描述 version string 是 length >=1 length <=8 版本号,本版本固定填写“2.0” sign_type string 是 length >=0 length <=8 签名算法类型,本版本固定为“ECDSA” mch_id string 是 length >=1 length <=32 通讯方的ID(即BaaS平台中的机构ID,可在【我的账户】中获取) mch_sign string 是 length >=1 length <=256 通讯方签名结果 chain_id string 是 length >=1 length <=32 链ID mch_pubkey string 是 length >=1 length <=64 通讯方公钥(可使用SDK生成,在测试链中:该公钥为用户在BaaS平台【我的账户】中上传的公钥;在专属链中:该公钥为用户在节点管理平台上传的公钥。) date string 是 length >=1 length <=32 查询日期 state int32数组 是 value >=0 资产状态 【当前支持:0,正常持有;2,已转出; 8:已兑付(转让签收场景下还有:3,已拒签; 4,已撤销)】 asset_type uint64数组 是 value >=0 资产类型,例如:0.商票1. 数字货币2. Q币3. 游戏装备4. 黄金5. 积分6. 卡券7. 股权 page_limit int32 是 value >=0 value <=20 查询条数 page_no int32 是 value >=1 页数 timestamp string 是 length >=0 当前unix时间戳(秒),与服务器时间相差过远会返回失败 请求示例:
http://{node_ip:node_port}/asset_rec_detail_query
{
"mch_sign": "MEUCIQDHRgIxF8GUSGyxKs/qSdP9Y6ESEiMqesJ6CgjBv4Wf1AIgKcjCO/ncDEsncvSjEJTXBCKO2/RIugAPK6x5FbhIrOQ=",
"version": "2.0",
"mch_pubkey": "A54sbt2MnFA+w+A6gL3M7o2O7Zq8m2Be7A5vHr1HVoHO",
"timestamp": "1545029439",
"chain_id": "chain_id",
"page_limit": 20,
"mch_id": "mch_id",
"state": [
7
]
"sign_type": "ECDSA",
"date": "2018-08-30",
"asset_type": [
1
]
"page_no": 1
}
- 应答:
{
"version":"2.0",
"sign_type":"ECDSA",
"mch_id":"trust_mch",
"mch_sign":"MEYCIQC9LBn3IUiYWsPVYuEXbav9GjR5qtERAxjzTjnXHVxZrgIhAL8rCtEryFpRGcI13mhCfKJqo1n3K5bwwv8ncmbuW+KL",
"retcode":0,
"retmsg":"SUCCESS",
"date":"2018-08-30",
"asset_list":[
]
"total":0,
"chain_id":"chain_id",
"mch_pubkey":"AjOZgNdnh6y0pH7yYyFts2xUm13wTd6upr/6jXjiHiVW"
}
- 应答字段解析:
名称 | 类型 | 必填 | 限制 | 描述 |
---|---|---|---|---|
version | string | 是 | length >=1 length <=8 | 版本号,本版本固定填写“2.0” |
sign_type | string | 是 | length >=1 length <=8 | 签名算法类型,本版本固定为“ECDSA” |
mch_id | string | 是 | length >=1 length <=32 | 通讯方的ID(即BaaS平台中的机构ID,可在【我的账户】中获取) |
mch_sign | string | 是 | length >=1 length <=256 | 通讯方签名结果 |
retcode | int32 | 是 | 应答code | |
retmsg | string | 是 | 应答信息,成功时内容为SUCCESS | |
date | string | 否 | length >=1 length <=32 | 查询日期 |
asset_list | message数组 | 否 | 用户资产信息 | |
asset_list.asset_id | string | 否 | length >=0 length <=64 | 资产ID |
asset_list.asset_account | string | 否 | length >=0 length <=64 | 资产持有方地址 |
asset_list.source_id | string | 否 | length >=0 length <=16 | 源资产ID(资产发行源) |
asset_list.asset_type | uint64 | 否 | value >=1 value <=32 | 资产类型 |
asset_list.amount | uint64 | 否 | value >=1 | 资产份额 |
asset_list.unit | string | 否 | length >=1 length <=32 | 资产单位 |
asset_list.state | int32 | 否 | value >=0 | 状态 |
asset_list.content | string | 否 | extra content | |
asset_list.trans_hash | string | 否 | length >=0 length <=64 | 区块链交易Fhash值 |
asset_list.trans_b_height | int64 | 否 | value >=0 | 交易所在的区块的高度 |
asset_list.trans_b_time | string | 否 | length >=0 | 交易所在的区块的创建时间(datetime) |
total | int32 | 否 | value >=1 | 总数 |
chain_id | string | 否 | length >=1 length <=32 | 链ID |
mch_pubkey | string | 是 | length >=1 length <=64 | 通讯方公钥(支持1.2以上版本) |
返回顶部