查询区块列表

最近更新时间:2019-10-18 10:54:11

1. 接口描述

接口请求域名: tbaas.tencentcloudapi.com 。

bcos分页查询当前群组下的区块列表

默认接口请求频率限制:20次/秒。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表见 公共请求参数

参数名称 必选 类型 描述
Action String 公共参数,本接口取值:GetBlockListHandler
Version String 公共参数,本接口取值:2018-04-16
Region String 公共参数,详见产品支持的 地域列表,本接口仅支持其中的: ap-guangzhou
Module String 模块名,固定字段:block
Operation String 操作名,固定字段:get_block_list
Offset Integer 记录偏移数
Limit Integer 每页记录数
GroupPk String 当前群组编号
BlockHash String 区块哈希

3. 输出参数

参数名称 类型 描述
TotalCount Integer 总记录数
GroupPk String 当前群组编号
List Array of BcosBlockObj 返回数据列表
RequestId String 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。

4. 示例

示例1 查询区块列表

输入示例

https://tbaas.tencentcloudapi.com/?Action=GetBlockListHandler
&Module=block
&Operation=get_block_list
&Offset=0
&Limit=4
&GroupPk=11_1
&BlockHash=
&<公共请求参数>

输出示例

{
  "Response": {
    "GroupPk": "11_1",
    "List": [
      {
        "BlockHash": "0xb30403facf6f7a65150fadc00cdfe2d27d1b7b672b382175af26bcd52b552ef8",
        "BlockNumber": 1,
        "BlockTimestamp": "2019-10-04 10:17:28",
        "CreateTime": "2019-10-04 10:20:16",
        "ModifyTime": "2019-10-04 10:20:16",
        "Sealer": "8c4affffccda617e4e16274df0e550012e94f8dcf34b2e138313bd965d08215807a90766690f6a4606f180447601d433b77a7783cfcc43b20eea7b4b5cd31eb3",
        "SealerIndex": 2,
        "TransCount": 1
      },
      {
        "BlockHash": "0x6ae08948b5c0385a0393f688271291b5806edce462eb67a8382528a6d757e525",
        "BlockNumber": 0,
        "BlockTimestamp": "2019-10-03 22:31:52",
        "CreateTime": "2019-10-03 22:34:57",
        "ModifyTime": "2019-10-03 22:34:57",
        "Sealer": "388a58a628c3dbb2aba593c7dc557ac36d386e931f15049ad8c5a3b2ea253e3edf25ccc80ac3012b6b78534889255cee2ac6f9b2dac80b47f75b52be0e4e8bb3",
        "SealerIndex": 0,
        "TransCount": 0
      }
    ],
    "RequestId": "d124dbd0-b0e5-4762-9ca1-37a99bd63a0f",
    "TotalCount": 2
  }
}

5. 开发者资源

API Explorer

该工具提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力,能显著降低使用云 API 的难度,推荐使用。

SDK

云 API 3.0 提供了配套的开发工具集(SDK),支持多种编程语言,能更方便的调用 API。

命令行工具

6. 错误码

以下仅列出了接口业务逻辑相关的错误码,其他错误码详见 公共错误码

错误码 描述
FailedOperation.CompileDeployedContract Bcos不能编译已经部署的合约。
FailedOperation.CompileDeployingContract Bcos不能编译正在部署的合约。
FailedOperation.ContractEditedByOtherAgency Bcos只能由该合约所属机构执行操作。
FailedOperation.DeleteDeployedContract Bcos合约已部署,无法删除。
FailedOperation.DeleteDeployingContract Bcos合约正在部署,无法删除。
FailedOperation.DeployContractNotCompile Bcos不能部署未编译的合约。
FailedOperation.InvalidGroupPk Bcos无效的群组编号。
FailedOperation.InvalidKeyUser Bcos无效的私钥用户信息。
FailedOperation.NewContract bcos新建合约失败。
FailedOperation.NotDeployedContract Bcos合约未部署。
InternalError.DBError BCOS数据库操作异常,请重试。
InternalError.InvalidContractParam Bcos无效的合约参数。
InternalError.MethodTypeNotSupport Bcos不支持的请求类型。
InternalError.ServerError BCOS服务器异常,请重试。
InvalidParameter.AccountParamError Bcos账号参数错误。
InvalidParameter.AgencyInvalid Bcos无效的机构信息。
InvalidParameter.AgencyNetParamInvalid Bcos新增机构网络关联信息入参错误。
InvalidParameter.AllianceIdOfNetEmpty Bcos所属联盟编号不能为空。
InvalidParameter.ContractIdInvalid Bcos无效的合约编号。
InvalidParameter.DataHadExist Bcos数据已存在,请勿重复添加。
InvalidParameter.EmptyParam BCOS无效参数。
InvalidParameter.ExpireTimeInvalid Bcos无效的失效时间。
InvalidParameter.FrontConnFail Bcos前置的IP或端口无效。
InvalidParameter.FrontIpInvalid Bcos IP格式错误。
InvalidParameter.FrontParamError Bcos新增前置服务参数错误。
InvalidParameter.FrontRequestFail Bcos前置服务调用失败。
InvalidParameter.InvalidContractArg Bcos无效的合约参数。
InvalidParameter.NetIdInvalid Bcos无效的网络编号。
InvalidParameter.NetParamError Bcos网络参数错误。
InvalidParameter.NewKeyUserParamError Bcos新增私钥用户参数错误。
InvalidParameter.NoInfoToDelete Bcos无可删信息,请确认后重试。
InvalidParameter.NotFoundValidFront Bcos没有有效的前置服务信息。
InvalidParameter.ReDeployedContract Bcos不能重复部署合约。
InvalidParameter.ReDeployingContract Bcos合约正在部署中,请勿重复操作。
InvalidParameter.RoleInvalid Bcos无效的角色。
MissingParameter.EmptyParam bcos缺少参数。
ResourceNotFound.EmptyData bcos查询不到数据。