资产兑付提交
注意:申请和提交要在同一个节点上操作
请求地址:http://{node_ip:node_port}/asset_settle_submit (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平台【我的账户】中上传的公钥;在专属链中:该公钥为用户在节点管理平台上传的公钥。) asset_type uint64 是 value >=0 value <=32 资产类型 transaction_id string 是 length >=1 length <=32 唯一标识一次交易的ID sign_list jsonArray 是 length >=0 length <=64 原待签名串和签名结果 sign_list.id int32 是 序号 sign_list.account string 是 签名账户 sign_list.sign_str string 是 签名串 sign_list.sign string 是 签名结果 timestamp int64 是 value >=0 当前unix时间戳(秒),与服务器时间相差过远会返回失败 请求示例:
http://{node_ip:node_port}/asset_settle_submit
{
"mch_sign": "MEQCIGcrT7Zq1om7ZXhkEc6PM3S6xGHYbfvEMkvqQjVWBkRZAiAXwiED+AgaVKIuBvIXRsImQ5sqrXg/a4mcBMX7KW9Ckg==",
"mch_pubkey": "A54sbt2MnFA+w+A6gL3M7o2O7Zq8m2Be7A5vHr1HVoHO",
"timestamp": "1545028831",
"sign_list": [
{
"account": "1LpqkE1FrCrumjV4aLLn4kL5P5NbyZ1PYD",
"sign_str": "9cea2cb6e6ec8d191c53c592303fc8aa7fffb820123793f8f81a19b5b0061a9b",
"id": 1,
"sign": "MEQCIFvz8HiESkLZBMXsxPkqLwvx8mmNXDPeHYO+3TWcCuNRAiBi4pOGczraU/WGY6hPGDA0QCOpYiKsAwdH6BAo0NDerQ=="
}
{
"account": "1LpqkE1FrCrumjV4aLLn4kL5P5NbyZ1PYD",
"sign_str": "242f728f366d8a709a7cabfa338c7cbbf104418316f3075fa5bfb8ea17702dcd",
"id": 2,
"sign": "MEMCHwCpozD0cDemBXoEe+6UQNmp0mtTYxkMa79IfqxKluwCIDtrdm1dwG7MWSBfRLOd9GXc/vkRu9hwAGUDX7IL5dqn"
}
]
"chain_id": "chain_id",
"mch_id": "mch_id",
"version": "2.0",
"sign_type": "ECDSA",
"asset_type": 1,
"transaction_id": "201812170005782180"
}
- 应答:
{
"version":"2.0",
"sign_type":"ECDSA",
"mch_id":"trust_mch",
"mch_sign":"MEUCIQDerW0+psvroQF7SMHSTCb4k6MV64IXUbulRept6PlApwIgLx4naeI2qgLZzFXtwqz8ioj3JuGUueR7LnupT321k3I=",
"chain_id":"chain_id",
"retcode":0,
"retmsg":"SUCCESS",
"left_asset_id":"27tMLXDif6mWSMq5BWv4nPDWyQpqNREngrgrWhS4rruc94P",
"left_asset_amount":757,
"recycle_account":"1CCD5bsX65Rd96P7kSXb1RJT9etMSQLk8i",
"trans_hash":"91485df79b0bbcc6957bea2fb1db1831d40f94871277f3dd169b2cd19771aefc",
"trans_b_height":2586,
"trans_b_timestamp":1545028876,
"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 | 通讯方签名结果 |
chain_id | string | 是 | length >=1 length <=32 | 链ID |
retcode | int32 | 是 | 应答code | |
retmsg | string | 是 | 应答信息,成功时内容为SUCCESS | |
left_asset_id | string | 否 | length >=0 length <=64 | 找零的资产ID |
left_asset_amount | int64 | 否 | value >=0 | 找零的资产份额 |
recycle_account | string | 否 | length >=0 length <=32 | 资产转入回收地址即表示资产被兑付后退出系统 |
trans_hash | string | 否 | length >=0 length <=64 | 区块链交易Fhash值 |
trans_b_height | int64 | 否 | value >=0 | 区块链交易高度 |
trans_b_timestamp | int64 | 否 | value >=0 | 区块时间 |
mch_pubkey | string | 是 | length >=1 length <=64 | 通讯方公钥(支持1.2以上版本) |
返回顶部