5.4.3.11 Get block data API

After the data is added to the chain, the off-BSN system will get the block information of the current transaction by calling this interface on the public city node gateway.

1. Interface address: https://PCNGatewayAddress/api/fabric/v1/node/getBlockData

2. Call method: POST

3. Signature algorithm: required and refer to Section 5.4.3.1

4. Call parameters

No. Field name Field Type Required Remarks
1 Header header Map Y
2 Body body Map Y
3 Signature Value mac String Y
Header
1 user unique ID userCode String Y
2 DApp unique ID appCode String Y
Body
1 Block number blockNumber Int64 N Can’t be null at the same time
2 Block HASH blockHash String N Can’t be null at the same time
3 Transaction Id txId String N Can’t be null at the same time

Example:

{"header": {"userCode": "USER0001202004151958010871292","appCode": "app0001202004161020152918451","tId": ""},"mac": "MEUCIQCrGthrAvNalUsWEdnDxZkNXF4nCpXOxIFQdp1YYhGvugIgKvYql9Ex6RCcOhqt6coufNPH/QhtKYNeThWJ2rEL+4g=","body": {"blockNumber": 6,"blockHash": "","txId": ""}}

5. Response parameters

No. Field name Field Type Required Remarks
1 header header Map Y
2 body body Map Y
3 signature value mac String Y
Header
1 Response ID code int Y 0: authentication successful -1: authentication failed
2 Response Message msg String N if code=0 then can be null
Body
1 Block Hash blockHash String Y
2 Block Number blockNumber Long Y
3 Previous Block Hash preBlockHash String Y
4 Block Data blockData String Y String generated by base64 calculation

Example:

{
  "header": {
    "code": 0,
    "msg": "success"
  },
  "mac": "MEQCICAgU3G6o1Ky6UeYgqEgCee27TS2F8ScH+jaSj6w20OCAiB+/6z1a2jG5m4vvjz1ft2LQdIsaG2BAXqcwxmSFyEIzg==",
  "body": {
    "blockHash": "b8366a63ed32fddec720872d206802e670222f29d9a8a32983d26b59dbfd6971",
    "blockNumber": 3,
    "preBlockHash": "6dcc69799682e2fc7ffa950c56031b807c54b7a098b4fd69db9cf8c97518bcea",
    "blockData": "CkYIAxIgbcxpeZa..............."
  }
}}
© 2019-2023 Red Date (Hong Kong) Technology Limited. all right reserved,powered by GitbookFile Modify: 2023-02-16 12:22:01

results matching ""

    No results matching ""

    results matching ""

      No results matching ""