接口描述
接口名: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 | |
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 | |
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 | 否 | - | 总数。 |