5.4.3.10 获取块信息接口

数据上链后，链下业务系统调用城市节点网关该接口会获得当前交易所在块信息（body.blockInfo），状态值（body.blockInfo.status）和交易 Id（body.blockInfo.txId）,如果状态值为 0 时，表示交易提交成功并且落块，可根据交易 Id 查询块信息。

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

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	否	不可同时为空

示例：

{
    "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	块大小	blockSize	Long	是	字节
5	当前块的交易数量	blockTxCount	Int	是
6	交易详情	transactions	[]TransactionData	是	交易详情
TransactionData：
1	交易Id	txId	String
2	交易状态	status	Int		[详见交易状态描述]
3	交易提交者	createName	String
4	交易时间戳秒	timeSpanSec	Int64
5	交易时间戳纳秒	timeSpanNsec	Int64

示例：

{
    "header": {
        "code": 0,
        "msg": "处理成功"
    },
    "mac": "MEUCIQC8nfFnHw4sEYJmaSTT1xepxMGgomxyJtt0ysyGgPB0AwIgfuuiegdGEbBi/2wmFCco39wmik3isLWtvnN9ZmJDTdk=",
    "body": {
        "blockHash": "fc83c306677925efee540b4d7b7ca73e06f144cae34c706f1101d6b395ada2da",
        "blockNumber": 6,
        "preBlockHash": "93c86551d812229274e144093cd4bd17dacb35bc6a01779930e11f43f886bf34",
        "blockSize": 7020,
        "blockTxCount": 1,
        "transactions": [{
            "txId": "a8639f3a796267e048d475b00fe7646a4524f1c20d71880e19708821177b7bdb",
            "status": 0,
            "createName": "test02@app0001202004161020152918451",
            "timeSpanSec": 1587271285,
            "timeSpanNsec": 26436800
        }]   
    }
}

5.4.3.10 获取块信息接口

5.4.3.10 获取块信息接口

results matching ""

No results matching ""

results matching ""

No results matching ""