api:notification_infoupdate

资料更新通知

接口说明

当管理员在企业QQ的账号中心更改企业信息,或者增删改员工、组织架构信息的时候,会通过第三方应用提供的这个地址通知相关信息的变更,以便第三方应用及时拉取最新信息,实现信息同步。

请求地址

由第三方指定的一个URL,必须在公网可以访问,因为企业QQ服务器,会直接向该网址发送GET请求

该回调设置的位置,使用管理员帐号登录企业账户中心,进入【应用中心】→【开发者模式】:

请求方式

get

请求参数

字段名称 字段类型 字段说明
company_id string 企业唯一标示符
timestamp int UNIX格式时间戳,发出此次请求的时间
vkey string 签名,算法为:
md5(company_id + app_id + timestamp)

加号表示字符串连接

notify_type_id int 更新类型:
1)企业基本信息
2)组织架构
3)员工信息
4)上下级关系发生变更
6)用户关闭应用
9)订单更新
notify_action_id int 动作类型:
101)企业基本信息更新
201)组织节点更新
202)新增组织节点
203)删除组织节点
301)员工基本资料修改
302)新增员工
303)删除员工
304)停用员工
305)启用员工
306)员工绑定手机
307)员工解绑手机
401)上级发生变化
402)下属发生变化
601)用户关闭应用
901)订单更新(附带参数:下表所示)
object_list string 在 notify_type_id 的值为1到4的时候,有此字段,逗号分隔的id列表,
如果是组织节点更新,内容就是组织节点的id列表,如果是员工更新,
就是员工open_id的列表

动作类型为901时,通知参数如下表所示:

字段名称 字段类型 字段说明
FCreateTime int 开通时间
FExpireTime int 过期时间
FLicense int 开通工号数
FCorpName string 企业简称
FProvince string 省份
FCity string 城市
FProductType int开通类型
1:新销售
2:续费
3:加工号
4:退费
FSalePrice string订单价格
FAgentName string经销商名

返回结果

字段名称 字段类型 字段说明
ret int 返回码:0 正常, >0 异常
msg string 状态信息

返回

api/notification_infoupdate.txt · 最后更改: 2016/04/22 16:55 (外部编辑)