5.4.3.11 获取块数据接口
数据上链后,链下业务系统调用城市节点网关该接口会获得当前交易所在块信息。
1. 接口地址:https://节点网关地址/api/fabric/v1/node/getBlockData
2. 通讯方式:POST
3. 签名算法:详见5.4.3.1应用接入签名算法
4. 请求参数
序号 | 字段名 | 字段 | 类型 | 必填 | 备注 |
---|---|---|---|---|---|
1 | 信息头 | header | Map | 是 | |
2 | 信息体 | body | Map | 是 | |
3 | 签名值 | mac | String | 是 | |
header: | |||||
1 | 用户唯一标识 | userCode | String | 是 | |
2 | 应用唯一标识 | appCode | String | 是 | |
body: | |||||
1 | 块号 | blockNumber | Int64 | 否 | 不可同时为空 |
2 | 块哈希 | blockHash | String | 否 | 不可同时为空 |
3 | 交易Id | txId | String | 否 | 不可同时为空 |
4 | 数据类型 | dataType | String | 否 | 可选为‘json’,如果是json,则返回格式化之后的数据,否则为base64字符串 |
示例:
{
"header":{
"userCode":"USER0001202004151958010871292",
"appCode":"app0001202004161020152918451",
"tId":""
},
"mac":"MEUCIQCrGthrAvNalUsWEdnDxZkNXF4nCpXOxIFQdp1YYhGvugIgKvYql9Ex6RCcOhqt6coufNPH/QhtKYNeThWJ2rEL+4g=","body":{
"blockNumber":6,
"blockHash":"",
"txId":""
}
}
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 | 块号 | blockNumber | Long | 是 | |
3 | 上一个块Hash | preBlockHash | String | 是 | |
4 | 块数据 | blockData | String | 是 | 如请求字段传的json,返回格式化后的json字符串,否则返回Base64字符串 |
示例:
{
"header": {
"code": 0,
"msg": "success"
},
"mac": "MEQCICAgU3G6o1Ky6UeYgqEgCee27TS2F8ScH+jaSj6w20OCAiB+/6z1a2jG5m4vvjz1ft2LQdIsaG2BAXqcwxmSFyEIzg==",
"body": {
"blockHash": "b8366a63ed32fddec720872d206802e670222f29d9a8a32983d26b59dbfd6971",
"blockNumber": 3,
"preBlockHash": "6dcc69799682e2fc7ffa950c56031b807c54b7a098b4fd69db9cf8c97518bcea",
"blockData": "CkYIAxIgbcxpeZa..............."
}
}}