腾讯微卡Wiki

# 获取组织架构变更事件推送

# 描述

应用接入后，组织架构变更事件会以数据推送形式通知应用，信息变更事件参考文档信息变更事件推送 (opens new window)

# 支持事件

事件类型 事件 事件描述
组织架构信息事件 addOrg 新增组织架构事件
updateOrg 修改组织架构事件
deleteOrg 删除组织架构事件

# 请求方法：

POST(application/json)

# 请求地址：

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

# 组织架构信息事件

# 请求参数：

{
    "app_key": "APP_KEY",
    "school_code":"1011789061",
    "event":"addOrg",
    "raw_data": "..."
}
参数 必填 类型 实例 参数说明
appkey 是 String APP_KEY应用接入时分配的key
school_code 是 String 1011789061主体的编号
event 是 String addOrg事件类型
raw_data 是 String ...加密数据

其中raw_data为加密后的数据，解密之后为：(加解密算法见注意事项)

{    
    "id": 9751,
    "name": "广东省深圳市南山区教育局",
    "parent_id": "0",
    "updated_at": "2019-04-22 11:34:05"
}
参数 必填 类型 实例 参数说明
id 是 Integer 9751 组织架构唯一id
name 是 String 广东省深圳市南山区教育局 组织架构名称
parent_id 是 Integer 0 父级组织架构唯一id
updated_at 是 Datetime 2019-04-22 11:34:05 组织架构信息更新时间

# 响应说明：

{
    "code": 0,
    "message": "ok",
}
参数 必填 类型 实例 说明
code 是 Integer 0 接收响应状态码，0为成功，非0时则认为接收方接受数据失败，将会进行重试
message 是 String ok 接收状态补充说明

# 注意事项

  1. 签名算法

具体算法参考签名算法 (opens new window) 签名验证工具参考签名验证工具 (opens new window)

  1. 加密算法

采用AES对称加密算法（AES/CBC/ZeroPadding 128位模式），具体算法见加解密 (opens new window)

KEY = APP_KEY
IV = APP_SECRET 前16位