5.4.5.8 获取块信息接口

当数据落链并生成区块链块后，可以根据块高或者块的哈希查询响应的块的信息，其中块高和块哈希不能同时为空。当同时不为空时，优先查询块高对应的块信息。

1. 接口地址：https://节点网关地址/api/xuperchain/v1/node/getBlockInfo

2. 通讯方式： POST

4. 请求参数

序号	字段名	字段	类型	必填	备注
1	信息头	header	Map	是
2	信息体	body	Map	是
3	签名值	mac	String	是
header
1	用户唯一标识	userCode	String	是
2	应用唯一标识	appCode	String	是
body
1	块高	blockHeight	uInt64	否	不可同时为空
2	区块hash	blockHash	String	否	不可同时为空

示例

    {
    "header":{
        "appCode":"CL1881038873220190902114314",
        "userCode":"newuser"
    },
    "body":
    {
        "blockHeight":0,
        "blockHash":"0xf27ff42d4be65329a1e7b11365e190086d92f9836168d0379e92642786db7ade"
    },
    "mac":"MEQCIGzS59y62I8EtDXiHCs37Q2c82tv6fap8gdnoHqoSNvuAiAtejOiLGhUe5ZVvnJENazQzW4HUUgNHfsV/BEl3A3dHg=="
    }

5. 响应参数

序号	字段名	字段	类型	必填	备注
1	信息头	header	Map	是
2	信息体	body	Map	是
3	签名值	mac	String	是
header：
1	响应标识	code	int	是	0：校验成功 -1：校验失败
2	响应信息	msg	String	否	code=0时可为null
body:
1	区块版本	version	int	是
2	块哈希	blockId	String	是
3	当前区块前置依赖区块id	preHash	String	是
4	区块所在高度	height	int	是
5	打包区块时间戳	timestamp	long	是
6	交易内容	transactions	[]TransactionData	是
7	区块包含的交易数	txCount	int	是
8	当前区块的后继区块id	nextHash	String	是
TransactionData
1	交易哈希	txId	String	是
2	块哈希	blockId	String	是
3	Tx格式版本号	version	String	是
4	合约的调用请求	contractRequests	[]contractRequest	是
5	收到tx的时间戳	receivedTimestamp	long	是
contractRequestData
1	合约名称	contractName	String	是
2	方法名称	methodName	String	是
3	参数	args	String	是

示例

```
{
    "header": {
        "code": 0,
        "msg": "处理成功"
    },
    "mac": "MEUCIA1qT8akZGUMG8leQYNhGhJSZULpUkP4ZPJYq1aRWagbAiEAiLES1A0NYsWa5NwuiIAOY3I/W8iCpSASNv+TAj+rgy8=",
    "body": {
        "version": 1,
        "blockid": "52e92335bf7711ac3cdd643672f1dfc2747555b5f27667b3d52802ecb1cfa11b",
        "preHash": "974264986dbc45463b9d14c640bc89f4fa11ed258dea61a7d90d5f47505b4e14",
        "height": 10,
        "timestamp": 1594092777000880499,
        "transactions": [
            {
                "txId": "134d69f1a4d98cc6f52590cb338a5bc4316cacf5a6ad5c858de224a0ef1288b6",
                "blockId": "52e92335bf7711ac3cdd643672f1dfc2747555b5f27667b3d52802ecb1cfa11b",
                "version": 1,
                "contractRequests": null,
                "receivedTimestamp": 0
            }
        ],
        "txCount": 1,
        "nextHash": "6ede8695bb8437990fce0d9becdd012b5f02ee3873694b0a005037c0d919dde5"
    }
}
```

5.4.5.8 获取块信息接口

5.4.5.8 获取块信息接口

results matching ""

No results matching ""

results matching ""

No results matching ""