共享信息查询

最近更新时间:2019-10-31 12:20:00

接口描述

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