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

接口描述

接口名:asset_rec_sum_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
查询日期。
state
int32 数组
value ≥ 0
资产状态,当前支持:0. 正常持有 2. 已转出 8. 已兑付(转让签收场景下:3. 已拒签 4. 已撤销)。
asset_type
uint64 数组
value ≥ 0
资产类型,例如:0. 商票 1. 数字货币 2. Q币 3. 游戏装备 4. 黄金 5. 积分 6. 卡券 7. 股权。
timestamp
String
length ≥ 0
当前 UNIX 时间戳(秒),与服务器时间相差过远会返回失败。

请求示例

{
"mch_sign": "MEQCICaMhgPKoInqrB2qYOXoQuMvVG4ibMnmfrOHoHzoUjLsAiBY4AIlFXPCUCiTEa1DFC42cOdbgYWCMfyElsOz6SqQ1Q==",
"mch_pubkey": "A54sbt2MnFA+w+A6gL3M7o2O7Zq8m2Be7A5vHr1HVoHO",
"timestamp": "1545029516",
"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":"MEQCIB4v6fdWJ5aJ3+LSBI6gAC9gsQ9cLkpsZuUDvQAMecV1AiAKl6nw3QpBhfm9gE+aX8bDRrq9TRhDnXtmlA0PbeWoOw==",
"retcode":0,
"retmsg":"SUCCESS",
"date":"2018-08-30",
"trans_list":[
],
"total":0,
"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,可从 账号信息 页面获取。
mch_sign
String
1 ≤ length ≤ 256
通讯方签名结果。
retcode
int32
-
应答 code,成功时为0。
retmsg
String
-
应答信息,成功时内容为 SUCCESS。
date
String
1 ≤ length ≤ 32
查询日期。
asset_list
message 数组
-
用户资产信息。
asset_list.state
int32
value ≥ 0
资产状态。
asset_list.asset_type
uint64
value ≥ 0
资产类型。
asset_list.count
int64
value ≥ 0
资产总个数。
asset_list.amount
int64
value ≥ 0
资产总额度。
total
int32
value ≥ 1
总数
chain_id
String
1 ≤ length ≤ 32
网络 ID。
mch_pubkey
String
1 ≤ length ≤ 64
通讯方公钥(支持1.2以上版本)。