接口描述
接口名:asset_account_query
请求方法:POST
请求字段:如下表
名称 | 类型 | 必填 | 限制 | 描述 |
version | String | 是 | 1 ≤ length ≤ 8 | 版本号,此版本固定填写“2.0”。 |
sign_type | String | 是 | 0 ≤ length ≤ 8 | 签名算法类型,此版本固定为 “ECDSA”。 |
mch_id | String | 是 | 1 ≤ length ≤ 32 | |
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 控制台,节点列表的节点公钥处上传。 |
owner_uid | String | 否 | 0 ≤ length ≤ 64 | 持有者 ID。 |
owner_account | String | 否 | 0 ≤ length ≤ 64 | 账户持有方地址。 |
asset_id | String | 否 | 0 ≤ length ≤ 64 | 资产 ID。 |
state | int32 数组 | 是 | value ≥ 0 | 资产状态。当前支持:0:正常持有。2:已转出。3:已拒签。4:已撤销。7:兑现中。8:已兑付。 |
page_limit | int32 | 是 | 0 ≤ value ≤ 20 | 查询条数。 |
page_no | int32 | 是 | value ≥ 1 | 页数。 |
timestamp | int64 | 是 | - | 当前 UNIX 时间戳(秒),与服务器时间相差过远会返回失败。 |
请求示例
{"asset_id": "123456","mch_sign": "MEUCIQCuRfVcOSJThFZ0Ar5MQ6d2nqrAtzJxTKS09Qan2/A/fAIgcZIO5TfN3iEY3RGoctosmkOEQ5rr7iYTrrB0WPOGojI=","version": "2.0","mch_pubkey": "A54sbt2MnFA+w+A6gL3M7o2O7Zq8m2Be7A5vHr1HVoHO","timestamp": "1546075782","chain_id": "chain_id","node_id": "node_id","page_limit": 5,"mch_id": "mch_id","state": [1,2,3],"sign_type": "ECDSA","page_no": 1}
应答示例
{"version": "2.0","sign_type": "ECDSA","mch_id": "trust_mch","mch_sign": "MEUCICHtFKTbrc4O5YwqsidX9oPgpJXw15Nb5b29wokxi7ryAiEA1QG5xTVLu6zto2I/z4hVFAppZmIZ9gx0vpIiD1En7d8=","retcode": 0,"retmsg": "SUCCESS","asset_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 | |
mch_sign | String | 是 | 1 ≤ length ≤ 256 | 通讯方签名结果。 |
retcode | int32 | 是 | - | 应答 code,成功时为0。 |
retmsg | String | 是 | - | 应答信息,成功时内容为 SUCCESS。 |
asset_list | message数组 | 否 | - | 查询得到的资产信息详情列表。 |
asset_list.asset_id | String | 否 | 0 ≤ length ≤ 64 | 资产 ID。 |
asset_list.asset_account | String | 否 | 0 ≤ length ≤ 64 | 资产持有方地址。 |
asset_list.source_id | String | 否 | 0 ≤ length ≤ 16 | 源资产 ID(资产发行源)。 |
asset_list.asset_type | uint64 | 否 | 1 ≤ value ≤ 32 | 资产类型。 |
asset_list.amount | uint64 | 否 | value ≥ 1 | 资产份额。 |
asset_list.unit | String | 否 | 1 ≤ length ≤ 32 | 资产单位。 |
asset_list.state | int32 | 否 | value ≥ 0 | 状态。 |
asset_list.content | String | 否 | - | extra content。 |
asset_list.trans_hash | String | 否 | 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 | 总数。 |
date | String | 否 | 1 ≤ length ≤ 32 | 查询日期。 |
chain_id | String | 否 | 1 ≤ length ≤ 32 | 网络 ID。 |
mch_pubkey | String | 是 | 1 ≤ length ≤ 64 | 通讯方公钥(支持1.2以上版本)。 |