事件通知回调
说明
当用户发生信息变更时回调给子应用服务端
回调通知说明
回调请求协议
HTTP
回调请求HTTP地址
业务方给定
回调请求HTTP方法
POST
回调请求HTTP签名
与B2C服务端请求一致(例:B2C消息写入)
参考下面文档中的app_sign 生成规则
回调请求HTTP头
Content-Type: application/json
回调请求HTTP通知参数
字段名称 | 变量名 | 必填 | 类型 | 实例值 | 说明 |
---|---|---|---|---|---|
租户代码 | tenant_code | 是 | string(16) | agile | 分配的租户代码 |
通知事件类型 | event_type | 是 | string(32) | user_logout | 枚举值 |
通知事件标识 | event_identify | 否 | string(64) | fa09e4554615d | 事件发生标识(当前为用户union_id) |
通知事件信息 | event_info | 否 | string(500) | "{\"unixtime\":1530841531,\"device_token\":\"\"}" | 事件发生信息(json的string) |
通知事件描述 | event_desc | 否 | varchar(128) | 用户登出 | 事件描述 |
注:
event_type
枚举值说明:
枚举值 | 说明 |
---|---|
user_logout | 用户登出,且通知的event_info例子为:"{\"unixtime\":1528943733}" |
user_relogin | 用户登录同一台设备,且通知的event_info例子为:"{\"unixtime\":1528943733,\"device_token\":\"登录的设备token\"}" |
user_new_login | 用户登录新设备,如果用户使用H5登录,则始终认为是登录新设备 ,且通知的event_info例子为:"{\"unixtime\":1528943733,\"device_token\":\"登录的新设备token\"}" |
user_modify_password | 用户修改密码,且通知的event_info例子为:"{\"unixtime\":1528943733}" |
user_reset_password | 用户重置密码,且通知的event_info例子为:"{\"unixtime\":1528943733}" |
user_modify_mobile | 用户修改手机号,且通知的event_info例子为:"{\"unixtime\":1528943733,\"new_mobile\":{\"code\":\"新手机号\",\"district\":\"国际区号\"}}" |
回调响应HTTP的头
Content-Type: application/json
回调响应HTTP的BODY的json说明
字段名称 | 变量名 | 必填 | 类型 | 实例值 | 说明 |
---|---|---|---|---|---|
响应码 | code | 是 | int | 200 | 200为成功,其他为失败 |
响应信息 | msg | 是 | string(64) | success | 信息 |
响应数据 | data | 否 | mixed | null | 数据 |
回调请求特殊说明
HTTP通知事件只通知一次,无论成功失败,不关心被请求方状态,只发送请求
回调请求和响应demo的HTTP包
请求
POST http://test-qmyxcg.myscrm.cn/api/callback/b2c/notify/handle?tenant_code=agile&random=5b3c32342ca83×tamp=1530671668&app_sign=a3ff078ea823a2efa45885faa4396f07&app_key=9b437adc87a98d3ffaad4747588e30f4&sign=b2ac5b48d83484f21bd15059ef88f023 HTTP/1.1
Host: test-qmyxcg.myscrm.cn
Accept: */*
Connection: Keep-Alive
Content-Type: application/json
Content-Length: 114
{"event_identify":"7779641a5d67f","event_type":"user_logout","event_info":"{\"unixtime\":1530671667}","event_desc":""}
响应
HTTP/1.1 200 OK
Date: Wed, 04 Jul 2018 02:35:11 GMT
Content-Type: application/json; charset=UTF-8
Connection: keep-alive
Vary: Accept-Encoding
Access-Control-Allow-Origin: *
Access-Control-Allow-Headers: Origin, X-Requested-With, Content-Type, Accept
Access-Control-Allow-Methods: GET, POST, OPTIONS
Content-Length: 78
{"code":200,"msg":"ok","data":null}