
# 查询范围内区块列表信息
#### 功能介绍
查询范围内区块列表信息，一次查询最大返回数量1000（仅支持专享版）
#### URI
GET /v1/store/block/list
表1Query参数 
| 参数          | 是否必选 | 参数类型    | 描述          |
|:---|:---|:---|:---|
| block_start | 是    | Integer | 查询区块的起始区块id |
| block_end   | 是    | Integer | 查询区块的结束区块id |
#### 请求参数
无
#### 响应参数
**状态码：200**
表2响应Body参数 
| 参数     | 参数类型                                                       | 描述   |
|:---|:---|:---|
| count  | Integer                                                    | 区块数量 |
| blocks | Array of [Block] objects | 区块列表 |
   
 表3Block 
| 参数        | 参数类型                                                                   | 描述      |
|:---|:---|:---|
| id        | Integer                                                                | 区块编号    |
| txs_count | Integer                                                                | 交易数量    |
| data_hash | String                                                                 | 区块体哈希   |
| pre_hash  | String                                                                 | 前一区块体哈希 |
| time      | String                                                                 | 区块生成时间  |
| txs       | Array of [Transaction] objects | 交易集合    |
   
 表4Transaction 
| 参数             | 参数类型                                                             | 描述                                                |
|:---|:---|:---|
| tx_id          | String                                                           | 交易id                                              |
| type           | String                                                           | 交易类型COMMON_TRANSACTION:普通交易，VOTE_TRANSACTION：投票交易 |
| block_id       | Integer                                                          | 区块号                                               |
| creator        | String                                                           | 创建者                                               |
| create_time    | String                                                           | 创建时间                                              |
| chaincode_name | String                                                           | 合约名称                                              |
| endorsor_orgs  | Array of strings                                                 | 背书组织                                              |
| read_set       | Array of [Readset] objects   | 读集                                                |
| write_set      | Array of [Writeset] objects | 写集                                                |
   
 表5Readset 
| 参数      | 参数类型                                                           | 描述   |
|:---|:---|:---|
| key     | String                                                         | key值 |
| version | Array of [Version] objects | 版本信息 |
   
 表6Version 
| 参数        | 参数类型    | 描述   |
|:---|:---|:---|
| block_num | Integer | 区块号  |
| tx_num    | String  | 交易编号 |
   
 表7Writeset 
| 参数        | 参数类型             | 描述 |
|:---|:---|:---|
| key       | String           | 键  |
| value     | Array of strings | 值  |
| signature | Array of strings | 签名 |
   
**状态码：400**
表8响应Body参数 
| 参数         | 参数类型   | 描述   |
|:---|:---|:---|
| error_code | String | 错误码  |
| error_msg  | String | 错误描述 |
   
#### 请求示例
无
#### 响应示例
**状态码：200**
区块列表
```
{
  "count" : 1,
  "blocks" : [ {
    "id" : 176,
    "txs_count" : 1,
    "data_hash" : "VdBUrdRs0krijfHb4JnTYB+ErZdAMhLVvoeKfJx3PfY=",
    "pre_hash" : "wFjpSWx5O/b7aUN06yovM5N4jNB/4/hT2c5Bhy7YaQk=",
    "time" : "2022-04-08T01:39:59Z",
    "txs" : [ {
      "tx_id" : "55d054add46cd24ae28df1dbe099d3601f84ad97403212d5be878a7c9c773df6",
      "type" : "COMMON_TRANSACTION",
      "block_id" : 176,
      "creator" : "user-1.org1.hwchain-tdc-eff8ed1eb.svc.cluster.local",
      "create_time" : "2022-04-08T01:39:57Z",
      "chaincode_name" : "tdccontract",
      "endorsor_orgs" : [ "org1" ],
      "read_set" : [ {
        "key" : "",
        "version" : [ {
          "block_num" : 0,
          "tx_num" : ""
        } ]
      } ],
      "write_set" : [ {
        "key" : "",
        "value" : [ ],
        "signature" : [ ]
      } ]
    } ]
  } ]
}
```
#### 状态码
| 状态码 | 描述   |
|:---|:---|
| 200 | 区块列表 |
| 400 | 错误响应 |
   
