有奖捉虫:云通信与企业服务文档专题,速来> HOT

接口描述

注意
申请和提交要在同一个节点上操作。
接口名:asset_settle_apply 请求方法: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 控制台,节点列表的节点公钥处上传。
src_uid
String
1 ≤ length ≤ 64
资产转出方(即资产发行方、资产所有者)的 UID。
src_account
String
1 ≤ length ≤ 64
资产转出方(即资产发行方、资产所有者)的账户地址。
src_account_pubkey
String
1 ≤ length ≤ 64
资产转出方(即资产发行方、资产所有者)的账户公钥。
asset_type
uint64
0 ≤ value ≤ 32
资产类型。
src_asset_list
String
1 ≤ length ≤ 1024
待兑付的持有方拥有的资产 ID 列表。
amount
int64
value ≥ 0
兑付份额。
extra_info
jsonObject
-
扩展信息。
timestamp
int64
value ≥ 0
当前 UNIX 时间戳(秒),与服务器时间相差过远会返回失败。

请求示例

{
"mch_sign": "MEUCIQDuzKLNgOhMMifKiUIZWwGSkNbt6TuhtwvDnnLKDW61mAIgUTUhHfv51KAYdBx3KVDW6OpXmNT0+Re0gp8KdiaHNkU=",
"src_account_pubkey": "AilPJBYrDQjXiJ4Wr7hjUTZjvhdODzZVqRw80N1terbc",
"src_uid": "owner_uid3386",
"src_account": "1LpqkE1FrCrumjV4aLLn4kL5P5NbyZ1PYD",
"timestamp": "1546075632",
"mch_pubkey": "A54sbt2MnFA+w+A6gL3M7o2O7Zq8m2Be7A5vHr1HVoHO",
"chain_id": "chain_id",
"node_id": "node_id",
"mch_id": "mch_id",
"version": "2.0",
"sign_type": "ECDSA",
"src_asset_list": "26aDpDeJWzbt1xH7Myu5Su5YXJFrK8SW63KGHLajXU4U5EN",
"amount": "7363",
"asset_type": 1,
"extra_info": {
"test": "test"
}
}

应答示例

{
"version": "2.0",
"sign_type": "ECDSA",
"mch_id": "trust_mch",
"mch_sign": "MEYCIQD+it1RsoeyGmlbvFmX8gZpur3eXCITRWPlvMkZJ8xC3gIhAOfROOkt3oeP9n0bEQgAdEpGjAOeQwJCXbqJ0Yk1sR3l",
"chain_id": "chain_id",
"retcode": 0,
"retmsg": "SUCCESS",
"transaction_id": "201812290005782269",
"sign_str_list": [
{
"id": 1,
"account": "1LpqkE1FrCrumjV4aLLn4kL5P5NbyZ1PYD",
"sign_str": "811bdd6898fcff18f2f0ce002cccdd91ea4e83316ecb94206b750fafd2b91622"
}
],
"left_asset_id": "27tSM9dn1viXCrysNkW2aHGjT9ddKYVE1CKWcn6LfjCvQsB",
"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,可从 账号信息 页面获取。
mch_sign
String
1 ≤ length ≤ 256
通讯方签名结果。
chain_id
String
1 ≤ length ≤ 32
网络 ID。
retcode
int32
-
应答 code,成功时为0。
retmsg
String
-
应答信息,成功时内容为 SUCCESS。
transaction_id
String
1 ≤ length ≤ 32
唯一标识一次交易的 ID。
sign_str_list
message 数组
0 ≤ length ≤ 64
待签名串。
sign_str_list.id
int32
-
序号。
sign_str_list.account
String
-
签名账户。
sign_str_list.sign_str
String
-
签名串。
left_asset_id
String
0 ≤ length ≤ 64
找零资产 ID。
mch_pubkey
String
1 ≤ length ≤ 64
通讯方公钥(支持1.2以上版本)。