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

接口描述

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