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

接口描述

接口名:Iss_Query 请求地址http://{node_ip:node_port}/Iss_Query
说明
node_ip:节点的内网/外网 IP, node_port:15903
请求方法:POST 请求字段:如下表
名称
类型
必填
限制
描述
version
String
1 ≤ length ≤ 8
版本号,此版本固定填写“2.0”。
sign_type
String
0 ≤ length ≤ 8
签名算法类型,此版本固定为 “ECDSA”。
mch_id
String
1 ≤ length ≤ 32
通讯方的 ID。腾讯云账号的 APPID,可从 账号信息 页面获取。
mch_pubkey
String
1 ≤ length ≤ 64
节点公钥,用户可在 TrustSQL 控制台,节点列表的节点公钥处上传。
mch_sign
String
1 ≤ length ≤ 256
通讯方签名结果,测试链的 TBaaS 平台和节点管理平台相同。
chain_id
String
1 ≤ length ≤ 32
网络 ID。
node_id
String
1 ≤ length ≤ 32
节点 ID。
account
String
1 ≤ length ≤ 64
记录方地址。用户可通过 SDK 生成的区块链地址直接进行使用,无需注册,该地址与真实用户之间的对应关系可由业务方进行维护。
t_hash
String
5个至少填1个
1 ≤ length ≤ 256
记录哈希。
b_height
String 数组
-
区块高度,格式 [start, end]。
b_time
String 数组
1 ≤ length ≤ 32
区块时间(YYYY-MM-DD HH:MM:SS),格式 [from, to]。
content
jsonObject
-
记录内容。由业务自行定义,长度大小不限,建议不超过4K字节,以免性能下降过多。采用标准的双引号而非单引号来封装 key 和 value,请求参数中不能转义双引号。
extra_info
jsonObject
-
扩展信息,由业务自行定义。长度大小不限,建议不超过4K字节,以免性能下降过多。业务对记录内容的分类或管理规则可放这里配置。
timestamp
int64
value ≥ 0
请求时间戳。当前 UNIX 时间戳(秒),与服务器时间相差过远会返回失败。
page_no
int32
value ≥ 0
页数。
page_limit
int32
value ≥ 0
每页显示数量。

请求示例

http://{node_ip:node_port}/Iss_Query
{
"mch_sign":"MEUCIQCXz+XWAlAfDm4fXbttlCl7Q1bbo6pvgaFPbfwDhfbsEgIgdy6yLc79TdiSYaeweck9Ev19r7aHcWDsmcq7M+12rVw=",
"account":"1FxHszg3ctmFudZzYQQnduN2Pan8NNygvW",
"b_height":[
"100",
"105837"
],
"mch_pubkey":"A54sbt2MnFA+w+A6gL3M7o2O7Zq8m2Be7A5vHr1HVoHO",
"timestamp":"1535956059",
"chain_id":"chain_id",
"node_id": "node_id",
"page_limit":15,
"b_time":[
"2018-08-01 15:55:54",
"2018-09-03 15:55:54"
],
"mch_id":"mch_id",
"version":"2.0",
"sign_type":"ECDSA",
"page_no":1
}

应答示例

{
"version":"2.0",
"sign_type":"ECDSA",
"mch_id":"trust_mch",
"mch_sign":"MEUCIQCbMEMWMscpCwvRpLtOrr4JS+2Dw/h+GLmk6jFaTe06nwIgJ7B3nVjXJ63ICyIFxrL1Jzngc93SIbRIJG9TUiQt4Ic=",
"retcode":0,
"retmsg":"SUCCESS",
"total":46,
"infos":[
{
"height":104962,
"hash":"eea2d047e774632c5232edb04d9783753d9f57fe73971be430d70fdde2f038b9",
"time":"2018-08-06 09:33:09",
"content":{
"test":"content_758582231"
},
"extra_info":{
"test":"test"
}
},
{
"height":104960,
"hash":"0ba635663bf05b01be6b2d57097f9ee690f7c1cf34348ac4fd024205d26efe70",
"time":"2018-08-06 09:32:47",
"content":{
"test":"content_957919762"
},
"extra_info":{
"test":"test"
}
},
{
"height":104959,
"hash":"f32ab5010fe6bb9275472ada1eff65dcf6db194b3ff09cff89858d4a64e3ca10",
"time":"2018-08-06 09:32:19",
"content":{
"test":"content_819213926"
},
"extra_info":{
"test":"test",
"bank":"ICBC"
}
},
{
"height":104958,
"hash":"6d5dbd8b2ca411fb827f42f1fbc909e199d100c1aeee073878c98fdeb4e72e98",
"time":"2018-08-06 09:28:16",
"content":{
"test":"content_5453955388"
},
"extra_info":{
"test":"test"
}
},
{
"height":104957,
"hash":"0fca0f6c3f5a7940202d684ed4a1355533cec86dacac335aae93f11aa1ec4bd9",
"time":"2018-08-06 09:27:24",
"content":{
"test":"content_1_1736120195"
},
"extra_info":{
"test":"test1"
}
},
{
"height":104956,
"hash":"f889342ffae78b8632ee80ab49ddd01d1fcbb903063317ca9762231cefd4fa01",
"time":"2018-08-06 09:27:22",
"content":{
"test":"content_5321308415"
},
"extra_info":{
"test":"test"
}
},
{
"height":104955,
"hash":"4f810e2513d5e6b8adac504f5600b83ee68c1f85bcca1c8bd94d5cc5a20ccfdf",
"time":"2018-08-06 09:27:15",
"content":{
"test":"content_3459990006"
},
"extra_info":{
"test":"test"
}
},
{
"height":104954,
"hash":"b2791079e019dce907e5c5854caabedff06646dd9f4b6b54cab7bb8e0d88e0cd",
"time":"2018-08-06 09:27:08",
"content":{
"test":"content_1839781763"
},
"extra_info":{
"test":"test_new"
}
},
{
"height":104953,
"hash":"de9bc5ee06ac90034d9e7c89cc091e7b99f7114161155cf6ba0c6e78269ac942",
"time":"2018-08-06 09:27:00",
"content":{
"test":"content_5490878247"
},
"extra_info":{
"test":"test"
}
},
{
"height":104952,
"hash":"38c8da3fad26bced503e05d1137c632f674f5f258e887a0a7836b68b95fc0456",
"time":"2018-08-05 20:36:22",
"content":{
"test":"content_1_8269466003"
},
"extra_info":{
"test":"test1"
}
},
{
"height":104951,
"hash":"4a6a0cf9007ae522cb4dd35b1ca4c2b7480e1f4f6c252c50f7068ebfce33bd11",
"time":"2018-08-05 20:36:21",
"content":{
"test":"content_9358439403"
},
"extra_info":{
"test":"test"
}
},
{
"height":104950,
"hash":"897dbf106de79403edd5e08bb9c0c3aa8ca091739e245218ccf54c1b929356d5",
"time":"2018-08-05 20:32:10",
"content":{
"test":"content_7954634521"
},
"extra_info":{
"test":"test"
}
},
{
"height":104949,
"hash":"14f004c1c994a262f15bd100de0002b8e12db87c38c3129ebf12915dc7dc7f1d",
"time":"2018-08-05 20:29:59",
"content":{
"test":"content_223461193"
},
"extra_info":{
"test":"test"
}
},
{
"height":104948,
"hash":"106432917774c76cd737c11e5cdd7f788b3430e4130d4bdbb903d225e05c59b2",
"time":"2018-08-05 19:56:50",
"content":{
"test":"content_1_7851380239"
},
"extra_info":{
"test":"test1"
}
},
{
"height":104947,
"hash":"9ef31fb5f82f66d67889eba3189443dea675843850d1a862389ef4ddd659d291",
"time":"2018-08-05 19:56:49",
"content":{
"test":"content_6336201485"
},
"extra_info":{
"test":"test"
}
}
]
}

应答字段解析

名称
类型
必填
限制
描述
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
value ≥ 0
应答 code,成功时为0,其它为失败。
retmsg
String
0 ≤ length ≤ 64
返回信息,如非空,为错误原因。
infos
message
-
记录列表 JSON 数组。
infos.content
message
-
记录内容,由业务自行定义。长度大小不限,建议不超过4K字节,以免性能下降过多。采用标准的双引号而非单引号来封装 key 和 value,请求参数中不能转义双引号。
infos.extra_info
message
-
扩展信息,由业务自行定义。长度大小不限,建议不超过4K字节,以免性能下降过多。业务对记录内容的分类或管理规则可放这里配置。
infos.hash
String
0 ≤ length ≤ 64
记录哈希。
infos.height
int64
value ≥ 0
区块高度。
infos.time
int64
0 ≤ value ≤ 64
区块时间。
total
init32
-
总数。