文档说明

共享信息查询

  • 请求地址：http://{node_ip:node_port}/Iss_Query （node_ip：节点的内网/外网ip， node_port：15903）
  • 请求方法：POST
  • 请求字段：
名称 类型 必填 限制 描述
version string 是 length >=1 length <=8 版本号，本版本固定填写“2.0”
sign_type string 是 length >=0 length <=8 签名算法类型，本版本固定为“ECDSA”
mch_id string 是 length >=1 length <=32 通讯方的ID（即BaaS平台中的机构ID，可在【我的账户】中获取）
mch_pubkey string 是 length >=1 length <=256 通讯方公钥（可使用SDK生成，在测试链中：该公钥为用户在BaaS平台【我的账户】中上传的公钥；在专属链中：该公钥为用户在节点管理平台上传的公钥。）
mch_sign string 是 length >=1 length <=256 通讯方签名结果，测试链的baas平台和节点管理平台相同
chain_id string 是 length >=1 length <=32 链ID
account string 否 length >=1 length <=64 记录方地址（用户可通过SDK生成的区块链地址直接进行使用，无需注册，该地址与真实用户之间的对应关系可由业务方进行维护）
t_hash string 5个至少填1个 length >=1 length <=256 记录哈希
b_height string数组 区块高度，格式[start ,end]
b_time string数组 length >=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",
    "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 是 length >=1 length <=8 版本号，本版本固定填写“2.0”
sign_type string 否 length >=0 length <=8 签名算法类型，本版本固定为“ECDSA”
mch_id string 是 length >=1 length <=32 通讯方的ID（即BaaS平台中的机构ID，可在【我的账户】中获取）
mch_sign string 是 length >=1 length <=256 通讯方签名结果
retcode int32 是 value >=0 返回状态码。0表示成功，其它为失败
retmsg string 是 length >=0 length <=64 返回信息，如非空，为错误原因。
infos message 否 记录列表json数组
infos.content message 是 记录内容。由业务自行定义，长度大小不限，建议不超过4K字节，以免性能下降过多。采用标准的双引号而非单引号来封装key和value，请求参数中不能转义双引号。
infos.extra_info message 是 扩展信息。由业务自行定义，长度大小不限，建议不超过4K字节，以免性能下降过多。业务对记录内容的分类或管理规则可放这里配置
infos.hash string 否 length >=0 length <=64 记录哈希
infos.height int64 否 value >=0 区块高度
infos.time int64 否 value >=0 value <=64 区块时间
total int32 否 总数
返回顶部