5.4.3.12 获取最新账本信息接口
获取当前链上应用最新的账本信息,包含块 Hash、上一个块 Hash、 当前块的高度等信息。
1. 接口地址:https://节点网关地址/api/fabric/v1/node/getLedgerInfo
2. 通讯方式:POST
3. 签名算法:详见5.4.3.1应用接入签名算法
4. 请求参数
序号 | 字段名 | 字段 | 类型 | 必填 | 备注 |
---|---|---|---|---|---|
1 | 信息头 | header | Map | 是 | |
2 | 信息体 | body | Map | 是 | |
3 | 签名值 | mac | String | 是 | |
header: | |||||
1 | 用户唯一标示 | userCode | String | 是 | |
2 | 应用唯一标识 | appCode | String | 是 |
示例:
{
"header":{
"userCode":"USER0001202004151958010871292",
"appCode":"app0001202004161020152918451",
"tId":""
},
"mac":"MEQCID7Z3J2PiRDOx7JasRamBZRTAHXj1XAG1K/DUkzJEwuiAiBIY5p3H2kArE7OuYLOgEqMHl15Xgj5Voi5zVPGhyU/+w==",
"body":{}
}
5. 响应参数
序号 | 字段名 | 字段 | 类型 | 必填 | 备注 |
---|---|---|---|---|---|
1 | 信息头 | header | Map | 是 | |
2 | 信息体 | body | Map | 是 | |
3 | 签名值 | mac | String | 是 | |
header: | |||||
1 | 响应标识 | code | int | 是 | 0:校验成功 -1:校验失败 |
2 | 响应信息 | msg | String | 否 | code=0时可为null |
body: | |||||
1 | 块Hash | blockHash | String | 是 | |
2 | 块高 | height | Long | 是 | |
3 | 上一个块Hash | preBlockHash | String | 是 |
示例:
{
"header": {
"code": 0,
"msg": "处理成功"
},
"mac": "MEUCIQC4PhYTBNyt1rSeBeZTdOly42CxILVgK1b/RlieA33G1gIgeodoEa5Ou0X4uWc/VGp0n6NKByhXlBbo22FME4xQ8aw=",
"body": {
"blockHash": "ab9366cf63881228863c884527fceefabc9ad2e375aa0bcbf71f17f75c7d3ff5",
"height": 8,
"preBlockHash": "fc83c306677925efee540b4d7b7ca73e06f144cae34c706f1101d6b395ada2da"
}
}