事件通知回调

说明

当用户发生信息变更时回调给子应用服务端

回调通知说明

回调请求协议

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&timestamp=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}

results matching ""

    No results matching ""