资产批量查询

最近更新时间:2019-10-30 10:22:07

接口描述

接口名:asset_account_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 控制台,节点列表的节点公钥处上传。
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 通讯方的 ID。腾讯云账号的 APPID,可从 账号信息 页面获取。
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以上版本)。