向区块链网络查询某一区块的信息。
API
GET /api/v1/networks/{network}/blocks/{num}
| Url Path 参数 | 描述 |
|---|---|
| network | 通道名称 |
| num | 区块块高, “latest” 表示当前最新的区块 |
返回结果
| 名称 | 类型 | 描述 |
|---|---|---|
| Success | Boolean | 请求是否成功 |
| Error | Error | - |
| Result | Block | - |
Error
| 名称 | 类型 | 描述 |
|---|---|---|
| code | Integer | 错误码 |
| message | String | 错误描述信息 |
| request_id | String | 请求ID |
Block
| 名称 | 类型 | 描述 |
|---|---|---|
| number | Integer | 区块块高 |
| hash | String | hex 编码后的当前区块 hash 值 |
| previous_hash | String | hex 编码后的上一区块 hash 值 |
| create_time | Integer | 当前区块创建时间,Unix秒级时间戳 |
| transactions | List<String> | 当前区块中,包含的所有交易的交易ID列表 |
| data | Object | 当区块为配置块时,该值为区块内容 common.Block |
示例
请求示例
curl -X GET "http://your.gateway.endpoint/api/v1/networks/channel3/blocks/281" -H "accept: application/json" -H "Authorization: Bearer <Your Access Token>"
正常返回示例
{"Success": true,"Result": {"number": 281,"hash": "4795bd5ac67db26b8b09e01da4e23b04a95a485914b0731ff5691c759df5725c","create_time": 1581581371,"previous_hash": "c5ae9e9385bba2848fe5dc56a5d1185ba41184ce0344dded33c81a9142756c86","transactions": ["e49d411a2ff32caa1688b5e0a07a957d2d8a4c8c124554772d07145214b3ba13","53b106675bb5d39b81142c572ec14dba92d9726f1216f96f008aac35be237fda","669e80e03dcc2e90af4494f2f7ada861e2b12b5041078a50065a3657312b558b"]},"Error": {"code": 200,"message": "Success","request_id": "313f10a5-bf79-48e1-9cdc-4345c9064a9c"}}
错误码
请参考错误码
该文章对您有帮助吗?