5.4.5.9 链码事件注册接口
参与的应用服务中,如果需要根据链码事件触发链下业务系统进行后续业务处理时,可调用该接口注册需要监听的链码事件。
1. 接口地址:https://节点网关地址/api/xuperchain/v1/event/register
2. 通讯方式: POST
3. 签名算法:详见5.4.5.1应用接入签名算法
4. 请求参数
序号 | 字段名 | 字段 | 类型 | 必填 | 备注 |
---|---|---|---|---|---|
1 | 信息头 | header | Map | 是 | |
2 | 信息体 | body | Map | 是 | |
3 | 签名值 | mac | String | 是 | |
header | |||||
1 | 用户唯一标识 | userCode | String | 是 | |
2 | 应用唯一标识 | appCode | String | 是 | |
body | |||||
1 | 合约名称 | contractName | String | 是 | |
2 | 合约事件key | eventKey | String | 是 | |
3 | 事件通知地址 | notifyUrl | String | 是 | 接收监听到的事件的地址 |
4 | 附加参数 | attachArgs | String | 否 |
示例
{
"header":{
"userCode":"USER0001202010201539390086090",
"appCode":"app0001202010221038364886804",
"tId":""
},
"mac":"MEUCIEjMeYepitdvXJLndgf7l1ufJDlC8YBxGDX/s/gkT5BBAiEA7Wzbgfnlh/dUjEeY1FSfZJEfSyHyW5fyA5g+h+boBZA=",
"body":{
"contractName":"cc_appxc_01",
"eventKey":"increase_event",
"notifyUrl":"http://192.168.7.141:8088/revNotify1",
"attachArgs":"abc=123"
}
}
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": "MEYCIQDFXWBPvvhqNUyBqOKL1Muq164wgL/FCUTd12AOAmak+QIhAL2vkO8KgZ74tk++D4qqYWCrX52QfSlIeJTn/FXeLOh7",
"body": {
"eventId": "9476afd7414e4ad2bce853b4e8f44bd4"
}
}