5.4.5.12 链码事件通知报文信息
该接口是由链下业务系统侧实现。城市节点网关在监听到注册的链码事件触发后调用该接口将事件执行结果通知给链下业务系统。
链下业务系统在收到城市节点网关通知后应返回一个包含 success的字符串,否则城市节点网关将尝试分别在第3、12、27、48 秒后再次发起通知,共计5次。
1. 通讯方式: POST
2. 签名算法:详见5.4.5.1应用接入签名算法
3. 请求参数
序号 | 字段名 | 字段 | 类型 | 必填 | 备注 |
---|---|---|---|---|---|
1 | 信息头 | header | Map | 是 | |
2 | 信息体 | body | Map | 是 | |
header | |||||
1 | 用户唯一标识 | userCode | String | 是 | |
2 | 应用唯一标识 | appCode | String | 是 | |
body: | |||||
1 | 事件Id | eventId | String | 是 | |
2 | 城市编码 | orgCode | String | 否 | 备用,目前为空 |
3 | 附加参数 | attachArgs | String | 否 | 注册时填写的附加参数 |
4 | 事件数据 | Payload | String | 是 | |
5 | 随机字符串 | nonceStr | String | 是 | 业务平台可根据该值判断是否接收过通知,同一个业务的多次通知中,该字符串不变 |
示例
{
"header": {
"userCode": "USER0001202010201539390086090",
"appCode": "app0001202010221038364886804"
},
"body": {
"eventId": "f4c6912f5b0540399ff080ef798763fa",
"orgCode": "",
"attachArgs": "abc=123",
"payload": "{\"bcname\":\"app0001202010221038364886804\",\"blockid\":\"cab4bf0b90b69ab4ca3e30dca7d52365376ac277f417648bf03751d7b4d84952\",\"block_height\":18184,\"txs\":[{\"txid\":\"e638c322a747b4f85ee7175ca7eec3d0d5ade3c970478b762d4b01c26035d951\",\"events\":[{\"contract\":\"cc_appxc_01\",\"name\":\"increase_event\",\"body\":\"12\"}]}]}",
"nonceStr": "40a182e08f6e454daf8a2a0d042dbb44"
},
"mac": "MEYCIQCcsoW0RJjLY4UX+yjWlSwRdYGaprxFyR/9F2b5gTQOUwIhAI98SanNujqgtjaAC/5YxOxxLPwVMevPq/XLRpHhtrHi"
}