本文导读

展开导读

文档首页/ 数字资产链 DAC/ 开发指南/ 数字资产管理/ 区块浏览/ 查询范围内区块列表信息

查询范围内区块列表信息

更新时间：2022-12-12 GMT+08:00

查看PDF

功能介绍

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

URI

GET /v1/store/block/list

表1 Query参数
参数	是否必选	参数类型	描述
block_start	是	Integer	查询区块的起始区块id 最小值：0 最大值：18446744073709551615
block_end	是	Integer	查询区块的结束区块id 最小值：0 最大值：18446744073709551615

请求参数

无

响应参数

状态码： 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：投票交易枚举值： 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" : 2,
  "blocks" : [ {
    "id" : 175,
    "txs_count" : 1,
    "data_hash" : "MgY/9ksThAb0kt7S83dqu+BwhHtsfyb505bUHNEQyu4=",
    "pre_hash" : "jsZZc1Cvv0zkA48HQWzZKVpUKWxPVFxDFsYDBHZCLHg=",
    "time" : "2022-04-08T01:39:43Z",
    "txs" : [ {
      "tx_id" : "32063ff64b138406f492ded2f3776abbe070847b6c7f26f9d396d41cd110caee",
      "type" : "COMMON_TRANSACTION",
      "block_id" : 175,
      "creator" : "user-1.org1.hwchain-tdc-eff8ed1eb.svc.cluster.local",
      "create_time" : "2022-04-08T01:39:42Z",
      "chaincode_name" : "tdccontract",
      "endorsor_orgs" : "org1",
      "read_set" : "key:\"IsAppr01\\000total\" version:<block_num:151 > ",
      "write_set" : "key:\"\\000IsAppr01\\000approval\\00039a05febed86e9bfb126daed4afedec2e7eb3fad\\0000d257260b95fdc3c0400c4e850cb4994d01f9cd2\\000\" value:\"{\\\"owner\\\":\\\"39a05febed86e9bfb126daed4afedec2e7eb3fad\\\",\\\"operator\\\":\\\"0d257260b95fdc3c0400c4e850cb4994d01f9cd2\\\",\\\"approved\\\":true}\""
    } ]
  }, {
    "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:\"SetOpti12\\000creator\" version:<block_num:170 > ,key:\"SetOpti12\\000total\" version:<block_num:170 >",
      "write_set" : "key:\"SetOpti12\\000name\" value:\"apple\" ,key:\"SetOpti12\\000symbol\" value:\"App\""
    } ]
  } ]
}

状态码

状态码	描述
200	区块列表
400	错误响应

父主题： 区块浏览

上一篇：获取区块链概览信息

下一篇：根据区块号查询区块信息

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！您可在我的云声建议查看反馈及问题处理状态。

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消

如您有其它疑问，您也可以通过华为云社区问答频道来与我们联系探讨

智能客服提问云社区提问

查询范围内区块列表信息

功能介绍

URI

请求参数

响应参数

请求示例

响应示例

状态码

相关文档

意见反馈

文档内容是否对您有帮助？

7*24

备案

专业服务

退订

建议反馈

售前咨询热线

文档反馈