有奖捉虫:办公协同&微信生态&物联网文档专题 HOT

接口描述

应用接入后,组织架构变更事件会以数据推送形式通知应用,信息变更事件参考 获取成员变更事件推送 接口。
支持事件:
事件类型
事件
事件描述
组织架构信息事件
addOrg
新增组织架构事件
updateOrg
修改组织架构事件
deleteOrg
删除组织架构事件

请求方法

POST(application/json)

请求地址

应用在接入时,需要提供接收事件推送地址进行配置。

输入参数

参数名称
参数描述
参数类型
是否必填
备注
app_key
应用接入时分配的 key
String
应用接入流程请参见 电子卡应用接入流程
school_code
主体的编号
String
-
event
事件类型
String
例如:addOrg(新增组织架构事件)
raw_data
加密数据
String
-
说明
其中 raw_data 为加密后的数据。
加密算法采用 AES 对称加密算法(AES/CBC/ZeroPadding 128位模式),具体算法请参见 加解密
解密后参数为:
参数名称
参数描述
参数类型
是否必填
id
组织架构唯一 ID
Integer
name
组织架构名称
String
parent_id
父级组织架构唯一 ID
Integer
updated_at
组织架构信息更新时间
Datetime

输出参数

参数名称
参数描述
参数类型
是否必填
code
接收响应状态码,0为成功,非0时则认为接收方接受数据失败,将会进行重试
Integer
message
接收状态补充说明
String

示例

输入示例

{
"app_key":"APP_KEY",
"school_code":"1011789061",
"event":"addOrg",
"raw_data":"..."
}
输入参数 raw_data 解密后:
{
"id":9751,
"name":"广东省深圳市南山区教育局",
"parent_id":"0",
"updated_at":"2019-04-22 11:34:05"
}

输出示例

{
"code": 0,
"message": "ok",
}