接口描述
接口名:trans_batch_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 控制台,节点列表的节点公钥处上传。 |
src_account | String | 否 | 1 ≤ length ≤ 64 | 发起方。 |
dst_account | String | 否 | 1 ≤ length ≤ 64 | 接收方。 |
transaction_id | String | 否 | 1 ≤ length ≤ 32 | 交易 ID。 |
trans_type | int32数组 | 否 | value ≥ 1 | 交易类型。当前支持: 1. 发行 2. 转让 3. 兑付 4 . 签收。 |
b_height | uint64数组 | 否 | value ≥ 0 | 区块高度范围。 |
state | int32数组 | 否 | value ≥ 0 | 交易状态。当前支持:2. 本地已申请 4. 已提交(转让签收场景下:6. 已签收 7. 已拒签 8. 已撤销)。 |
page_limit | int32 | 是 | 0 ≤ value ≤ 20 | 查询条数。 |
page_no | int32 | 是 | value ≥ 1 | 页数。 |
timestamp | int64 | 是 | - | 当前 UNIX 时间戳(秒),与服务器时间相差过远会返回失败。 |
trans_hash | String | 否 | 0 ≤ length ≤ 64 | 区块链交易 Fhash 值。 |
请求示例
{"mch_sign": "MEQCID9v1SS0K1RDjbe5OnbLWRd9fY2SMWhRAHsW8IbgzStCAiBzEMh+6/cUmclb2AzWY2NPfLqujLhp7AhER/tBHwyaKA==","src_account": "1LpqkE1FrCrumjV4aLLn4kL5P5NbyZ1PYD","b_height": [1,107087],"version": "2.0","mch_pubkey": "A54sbt2MnFA+w+A6gL3M7o2O7Zq8m2Be7A5vHr1HVoHO","timestamp": "1546075883","sign_type": "ECDSA","chain_id": "chain_id","node_id": "node_id","page_limit": 3,"state": [5,6],"mch_id": "mch_id","trans_type": [2],"dst_account": "1BMeqGM9h1yoJtzUiuFR5xUeTyWs3tNtBD","page_no": 1}
应答示例
{"version": "2.0","sign_type": "ECDSA","mch_id": "trust_mch","mch_sign": "MEQCIAabFPJh2Hj06Ubxn4gqfzpf+6L0lKIXI8KOrVXFdndwAiA4EZM9/P+xQmZyu6KrJ/GTMWPf5EswQ8YMIVQshM0GYQ==","retcode": 0,"retmsg": "SUCCESS","total": 99,"trans_list": [{"trans_hash": "910b823c321c7d7e437f40c2a40e9227944b31175a4e9a5f834768f8ce47a0b4","transaction_id": "201812290005782263","trans_type": 2,"trans_state": 5,"src_account": "1LpqkE1FrCrumjV4aLLn4kL5P5NbyZ1PYD","dst_account": "1BMeqGM9h1yoJtzUiuFR5xUeTyWs3tNtBD","src_asset_list": [{"asset_id": "26aRcKTj8Z9yBWZsPMvgD1SnDFB2nGYc3rnQfkyYDpstLT4","fee_amount": 1,"dst_amount": "9389"},{"asset_id": "26aK5mnmjajFHxBcmHxouhgQfmtLLxwvND4dtjReRLDH1E3","fee_amount": 0,"dst_amount": "9389"}],"dst_asset_id": "26aJec6fvoLmJLWFaWQr5QoYz9zYqKdZwTaDLvY4CckQp5k,27tMRgyjsEv1P7EGgyLzzrh5VVWXG4NHDXn2P7nQ1wEcf6N,29CQCmroogVFTsxHoSH9vJabzq2Vgo6zVbyqRK2jqFipW6z,2AWSyrjsk84VYegJuuDJqkU8WAYU7XqhmgBeTWH5eaD2M7c","left_asset_id": "27tMKbPxh7qkHV4pKSrBCmiCrRzfp9Yq2n6E1C8mh1iwWCb","dst_amount": 18778,"left_amount": 1,"fee_amount": 1,"extra_info": {"test": "test"},"sign_str_list": [{"id": 1,"account": "1BMeqGM9h1yoJtzUiuFR5xUeTyWs3tNtBD","sign_str": "489e75d067a359c3d9988eb06ba1b88ed033ffe6543130306ac7b8960797c148"}],"b_height": 3758,"b_time": "2018-12-29 17:22:20","business": 2},{"trans_hash": "8d8e92a7aa1bd7beb0b50c4c887c140401a64e7c7e6c66ba97720991c29f91f3","transaction_id": "201812250005782232","trans_type": 2,"trans_state": 6,"src_account": "1LpqkE1FrCrumjV4aLLn4kL5P5NbyZ1PYD","dst_account": "1BMeqGM9h1yoJtzUiuFR5xUeTyWs3tNtBD","src_asset_list": [{"asset_id": "26aMQugYSY9HobCPzdfwdARhcDngvQafxGiCjWLQ1JQURfE","fee_amount": 1,"dst_amount": "9999999999997"},{"asset_id": "26aEP82bruJ5QHcdaSGAGRDRr8auBNpmQaN1xt2BoNm1H7i","fee_amount": 0,"dst_amount": "10000000000000"}],"dst_asset_id": "26aJJtoJm7K6GcADCvGzah5hi6VduBHyF867Xf7jeVHjiJ6,27tM5ygNhYtLMNtEKPD9W8yEDS1cKv2gXCHvZrN5TomwZJi,29CPs4ZSdzTaS9cFRr9JRarkimXakemPoGVjc3cRH8G9QKL,2AWSe9SWaS2pWvLGYK5TM2kHE73ZBPW75LhYeErm6SkMFKx","left_asset_id": "27tQLtyHpF4sdtEmBZbFYd5vsWHSuc3pqCFRLPkB5qPVXjU","dst_amount": 19999999999997,"left_amount": 2,"fee_amount": 1,"extra_info": {"test": "test"},"b_height": 3502,"b_time": "2018-12-25 16:24:25","business": 2},{"trans_hash": "14dcd86d7e3046fed08913ecddc6ca2b297b8084d89dd499340a3043c7567ffa","transaction_id": "201812170005782168","trans_type": 2,"trans_state": 6,"src_account": "1LpqkE1FrCrumjV4aLLn4kL5P5NbyZ1PYD","dst_account": "1BMeqGM9h1yoJtzUiuFR5xUeTyWs3tNtBD","src_asset_list": [{"asset_id": "26aRGWEHrvxYjcSs3Z9feA8Y33cppNBKtDNwszeRMazNFMi","fee_amount": 1,"dst_amount": "9999999999997"},{"asset_id": "26a95ypAcjgQRMKbLRSJw17nCaBmkMNLkPrB9KysTot5GQp","fee_amount": 0,"dst_amount": "10000000000000"}],"dst_asset_id": "26aABkh7XFdxeEitdf23WPdi7VpfyN2QUqceKSRh4Ufuqcm,27tCxqaBThDCj1Suk7xCRqXEcqLeQ6m7kupTMdg2soA7gdP,29CFjvTFQ8nSonAvratMMHQm8ArcpqVq2z2GPpvNh7eKXe1,2AWJX1LKLaMgtYtwy3pWGjJHdWNbFaEYK4E5S2AiWS8XNed","left_asset_id": "27tPpqY6A2AwoMJDnVkBaoZbSiERuWxqTp1UhpmcJcgUB2e","dst_amount": 19999999999997,"left_amount": 2,"fee_amount": 1,"extra_info": {"test": "test"},"b_height": 2574,"b_time": "2018-12-17 14:33:32","business": 2}],"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 | 通讯方签名结果。 |
chain_id | String | 否 | 1 ≤ length ≤ 32 | 网络 ID。 |
retcode | int32 | 是 | - | 应答 code,成功时为0。 |
retmsg | String | 是 | - | 应答信息,成功时内容为 SUCCESS。 |
total | int32 | 否 | value ≥ 0 | 交易数量。 |
trans_list | message数组 | 否 | - | 具体交易信息详细列表。 |
trans_list.trans_hash | String | 否 | 0 ≤ length ≤ 64 | 区块链交易 Fhash 值。 |
trans_list.transaction_id | String | 否 | 1 ≤ length ≤ 32 | 交易 ID。 |
trans_list.trans_type | int32 | 否 | value ≥ 1 | 交易类型。 |
trans_list.trans_state | int32 | 否 | value ≥ 1 | 交易状态。 |
trans_list.src_account | String | 否 | 0 ≤ length ≤ 64 | 资产转出账户。 |
trans_list.dst_account | String | 否 | 0 ≤ length ≤ 64 | 资产转入账户。 |
trans_list.src_asset_list | List | 否 | 1 ≤ length ≤ 64 | 资产转出的 ID 列表。 |
trans_list.dst_asset_id | String | 否 | 1 ≤ length ≤ 64 | 资产转入的 ID。 |
trans_list.left_asset_id | String | 否 | 1 ≤ length ≤ 64 | 剩余找零资产 ID。 |
trans_list.dst_amount | uint64 | 否 | value ≥ 1 | 转出到目标账户的资产份额。 |
trans_list.left_amount | uint64 | 否 | value ≥ 1 | 剩余的资产份额。 |
trans_list.fee_amount | uint64 | 否 | value ≥ 1 | 手续费份额。 |
trans_list.extra_info | String | 否 | - | 扩展信息。 |
trans_list.sign_str_list | String | 否 | - | 当状态为2/3时,表示 JSON String 格式待签名串。 |
trans_list.b_height | int64 | 否 | value ≥ 0 | 交易所在的区块的高度。 |
trans_list.b_time | String | 否 | length ≥ 0 | 交易所在的区块的创建时间。 |
trans_list.business | int64 | 否 | - | 业务类型。 |
date | String | 否 | 1 ≤ length ≤ 32 | 查询日期 |
mch_pubkey | String | 是 | 1 ≤ length ≤ 64 | 通讯方公钥(支持1.2以上版本)。 |