5.4.3.14 块事件注册接口
参与的应用服务中,如果需要根据块事件触发链下业务系统进行后续业务处理时,可调用该接口注册需要监听的块事件。
1. 接口地址:https://节点网关地址/api/fabric/v1/chainCode/event/blockRegister
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 | 事件通知地址 | notifyUrl | String | 是 | 接收监听到的块事件的地址 |
2 | 附加参数 | attachArgs | String | 否 |
示例
{"header":{"userCode":"USER0001202007101641243516163","appCode":"app0001202101191411238426266","tId":""},"mac":"MEUCIQClsjKy/ee1qaYrItzCO1bMfjs0g0kPu8+YOCjbk3rPRAIgSfeyYvfeoh8QciZPG4fZQepaiyh7PmmWjYzFSqylT/c=","body":{"chainCode":"","eventKey":"","notifyUrl":"http://192.168.6.78:58011/v1/fabric/test","attachArgs":"a=1"}}
5. 响应参数
序号 | 字段名 | 字段 | 类型 | 必填 | 备注 |
---|---|---|---|---|---|
1 | 信息头 | header | Map | 是 | |
2 | 信息体 | body | Map | 是 | |
3 | 签名值 | mac | String | 是 | |
Header | |||||
1 | 响应标识 | code | int | 是 | 0:注册成功-1:注册失败 |
2 | 响应信息 | msg | String | 是 | |
Body | |||||
1 | 事件编码 | eventId | String | 是 |
示例
{
"header": {
"code": 0,
"msg": "success"
},
"mac": "MEUCIQC6PKsSqfkQGLrqi2vMpZzBP5beLhyP+fXVr8S5aqhaagIgaEtAnsuiubibYoYZzQ/8aGYErzm5rtU8Oj952OuHgCo=",
"body": {
"eventId": "002f0e1f0b0f4331ab541461547a38d6"
}
}