回调通知
在集成微盛开放接口与企业系统时,我们往往需要搭建一个回调服务,可以及时获取到状态变化
1、回调服务配置
配置回调服务,目前只需要一个配置项:URL
URL为回调服务地址,由开发者搭建,用于接收通知消息或者事件
2、回调服务需要实现的功能
配置回调服务时,目前需要能支持HttpPost
2.1 支持HttpPost请求接收业务数据
假设企业的接收消息的URL设置为 https://platform.wshoto.com/notify
当用户触发回调行为时,会发送回调消息到填写的URL,请求内容如下:
请求方式: POST(HTTPS)
请求地址: https://platform.wshoto.com/notify
接收数据格式:
{
"message_id": "message_id",
"type": 0,
"content": "msg_content",
"gmt_create": 1653375234
}
参数说明:
参数 | 类型 | 说明 |
---|---|---|
message_id | string | 消息id |
type | int | 消息类型 |
content | string | 消息结构体 |
gmt_create | long | 消息创建时间 |
2.2 接收消息请求的说明
- 微盛服务器在五秒内收不到响应会断掉连接,并且重新发起请求,总共重试三次。
- 当接收成功后,返回SUCCESS表示接收ok,其他错误码微盛后台会一律当做失败并发起重试
- 关于重试消息排重,推荐使用message_id排重
消息类型说明:
枚举值 | 说明 |
---|---|
15 | 客户变更通知 |
16 | 客户群变更通知 |
19 | 代客订单变更消息推送 |
20 | 付款回单变更消息推送 |
21 | 自定义字段变更消息推送 |
32 | 客户积分变更消息推送 |
34 | 商城订单变更消息推送 |
35 | 商城售后订单变更消息推送 |
40 | 超时回复生成记录消息推送 |
41 | 触发敏感词生成记录消息推送 |