会员变更通知
会员信息发生创建、认证、资料修改、合并等变化时,平台会向友商配置的回调地址 POST 推送会员最新数据。
POST友商回调地址(配置路径:后台-设置-开放平台-订阅事件-添加订阅)
配置方式
- 登录信多帮管理后台
- 进入 后台 → 设置 → 开放平台 → 订阅事件 → 添加订阅
- 选择「会员变更」事件,填写友商回调 URL
- 保存后,会员发生变更时将自动推送
说明
- 回调为服务端对服务端请求,请确保 URL 公网可访问
- 收到回调后请返回 HTTP 200
- 请求以 表单 方式提交,其中
request_data是一段 JSON 字符串,解析后才能读到会员内容
请求格式
| 字段 | 说明 |
|---|---|
| type | 固定值 user_info |
| exchange_type | 变更类型,见下表 |
| request_data | JSON 字符串,解析后为下表 request_data 对象 |
变更场景
exchange_type 表示本次推送对应的变更类型:
| 值 | 场景 |
|---|---|
| 1 | 创建会员(小程序进入或后台导入) |
| 2 | 小程序认证 |
| 3 | 小程序修改会员信息 |
| 4 | 小程序授权头像/昵称 |
| 5 | 后台修改会员信息 |
| 6 | 合并会员 |
请求体结构
request_data 字段
| 字段 | 类型 | 说明 |
|---|---|---|
| uid | Number | 会员 ID |
| unionid | String | 微信开放平台 unionid(未绑定时为空) |
| username | String | 微信昵称 |
| phone | String | 手机号 |
| headimgurl | String | 头像 URL |
请求示例
解析 request_data 后的 JSON 示例:
{
"type": "user_info",
"exchange_type": 2,
"request_data": {
"uid": 10086,
"unionid": "oXXXX",
"username": "张三",
"phone": "13800138000",
"headimgurl": "https://example.com/avatar.jpg"
}
}
信息
上方示例为方便阅读,将解析后的完整结构展示在一起。实际 HTTP 请求中,type、exchange_type、request_data 三个字段以表单方式提交,request_data 的值是 JSON 字符串。
接收方要求
| 项目 | 要求 |
|---|---|
| 响应状态码 | 返回 HTTP 200 表示接收成功 |
| 幂等 | 同一会员可能多次变更推送,建议按 uid + exchange_type 去重 |
| 完整资料 | 推送为精简字段;需更多会员属性时可调用 获取会员列表 主动查询 |
相关接口
- 主动查询会员:
获取会员列表