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..............."
  }
}}
Copyright 北京红枣科技有限公司

results matching ""

    No results matching ""

    results matching ""

      No results matching ""