5.4.4.9 获取块信息接口

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

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

  2. 通讯方式:POST

  3. 签名算法:详见5.4.4.1 应用接入签名算法

  4. 请求参数

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

  示例:

{
    "header":{
        "appCode":"CL1881038873220190902114314",
        "userCode":"newuser"
    },
    "body":{
        "blockNumber":22,
        "blockHash":"0xf27ff42d4be65329a1e7b11365e190086d92f9836168d0379e92642786db7ade"
    },
    "mac":"MEQCIBRhaM2szckWl9N9qcqnaYXOXGQw7SfII9DlRvxcI3YVAiBt4XeNs+EUjhBNSr3IjLRPZucsuGHxfjt9RiaNIQS8cA=="
}

  5. 响应参数

序号 字段名 字段 类型 必填 备注
1 信息头 header Map
2 信息体 body Map
3 签名值 mac String
header:
1 响应标识 code int 0:校验成功
-1:校验失败
2 响应信息 msg String code=0 时可为 null
body:
1 块哈希 blockHash string
2 块号 blockNumber Int
3 上一个块哈希 parentBlockHash String
4 块大小 blockSize Int
5 落块时间 blockTime Int 毫秒格式时间 戳
6 交易提交者 author string
7 交易信息 transactions []TransactionData
TransactionData:
1 交易 Id txId string
2 块哈希 blockHash String
3 块号 blockNumber Int
4 使用 gas gasUsed Int
5 发送者的地址 from String
6 接收者的地址 to string
7 转移的值 value Int
8 交易的输入 input String

  示例:

{
    "code": "0",
    "msg": "处理成功",
    "data": {
        "blockHash": "0x199eca276b60473dd65f8b36641684456694b419d89ef41b4953a9cdac848305",
        "blockNumber": 1,
        "parentBlockHash": "0xa6886f12ee91470e35546432413ed372615f8d4c23fa82e8381b3e5b31219d4c",
        "blockSize": 0,
        "blockTime": 1587125168039,
        "author": "",
        "transactions": [
            {
                "txId": "0x8ee0c68e222742b5b70878265d3fdbd3a8e0d549da42a298a4ae872ca4fbfd89",
                "blockHash": "0x199eca276b60473dd65f8b36641684456694b419d89ef41b4953a9cdac848305",
                "blockNumber": 1,
                "gasUsed": 100000000,
                "from": "0x08ac3132a6c7e6ca5a7fbaf0521bb8b6f370ed35",
                "to": "",
                "value": 0,
                "input": "0x60806040523480156200001157600080fd5b506110016000806101000a81548173ffffffffffffffffffffffffffffffffffffffff021916908373ffffffffffffffffffffffffffffffffffffffff1602179055506000809054906101000a900473ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1663c92a78016040805190810160405280600681526020017f745f6261736500000000000000000000000000000000000000000000000000008152506040518263ffffffff167c01000000000000000000000000000000000000000000000000000000000281526004016200010191906200024a565b602060405180830381600087803b1580156200011c57600080fd5b505af115801562000131573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525062000157919081019062000174565b50620002f4565b60006200016c8251620002a3565b905092915050565b6000602082840312156200018757600080fd5b600062000197848285016200015e565b91505092915050565b6000620001ad8262000298565b808452620001c3816020860160208601620002ad565b620001ce81620002e3565b602085010191505092915050565b6000601382527f626173655f6b65792c626173655f76616c7565000000000000000000000000006020830152604082019050919050565b6000600782527f626173655f6964000000000000000000000000000000000000000000000000006020830152604082019050919050565b60006060820190508181036000830152620002668184620001a0565b905081810360208301526200027b8162000213565b90508181036040830152000000"
            }
        ]
    }
}
Copyright 北京红枣科技有限公司

results matching ""

    No results matching ""

    results matching ""

      No results matching ""