文档首页/ 数字资产链 DAC/ 开发指南/ 数字资产管理/ 区块浏览/ 查询范围内区块列表信息
更新时间：2025-06-06 GMT+08:00
查看PDF
分享

查询范围内区块列表信息

功能介绍

查询范围内区块列表信息，一次查询最大返回数量1000（仅支持专享版）

URI

GET /v1/store/block/list

表1 Query参数

参数

是否必选

参数类型

描述

block_start

是

Integer

查询区块的起始区块id

block_end

是

Integer

查询区块的结束区块id

请求参数

无

响应参数

状态码：200

表2 响应Body参数

参数

参数类型

描述

count

Integer

区块数量

blocks

Array of Block objects

区块列表
表3 Block

参数

参数类型

描述

id

Integer

区块编号

txs_count

Integer

交易数量

data_hash

String

区块体哈希

pre_hash

String

前一区块体哈希

time

String

区块生成时间

txs

Array of Transaction objects

交易集合
表4 Transaction

参数

参数类型

描述

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

写集
表5 Readset

参数

参数类型

描述

key

String

key值

version

Array of Version objects

版本信息
表6 Version

参数

参数类型

描述

block_num

Integer

区块号

tx_num

String

交易编号
表7 Writeset

参数

参数类型

描述

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

错误响应
父主题： 区块浏览

相关文档