5.4.3.13 链码事件注册接口
参与的应用服务中,如果需要根据链码事件触发链下业务系统进 行后续业务处理时,可调用该接口注册需要监听的链码事件。
1. 接口地址: https://节点网关地址/api/fabric/v1/chainCode/event/register
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 | 链码Code | chainCode | String | 是 | |
2 | 链码事件key | eventKey | String | 是 | |
3 | 链码事件通知地址 | notifyUrl | String | 是 | 接收监听到的链码事件的地址 |
4 | 附加参数 | attachArgs | String | 否 |
示例:
{
"header":{
"appCode":"CL20191107112252",
"userCode":"lessing"
},
"body":{
"attachArgs":"name=张三&age=20",
"chainCode":"cc_bsn_test_00",
"eventKey":"test01",
"notifyUrl":"http://192.168.6.128:8080/api/event/notifyUrl"
},
"mac":"MEUCIQCjzPr4KZVild2Vm5YgcunOXTh9mQK2QfWcRnYCk+jOzgIgDW6oHca7/249M43p2ElwiMNbuejdwAnyW5OwiMqiWCQ="
}
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": "注册链码事件成功"
},
"body": {
"eventId": "bd3391deedbe44a7ad5b7f80ce59abfa"
},
"mac": "MEQCIENLpj2R9mRL100vcMXs0X5rwfSjB/U7kMg+76GjEPNJAiBlUo/Eyj49uXTPrzRW0m4rJ0NQIkZnDMPbyalxojXwrA=="
}