获取应用可用范围变更事件推送

描述

应用接入后，开启主体下第三方应用可用范围变更事件会以数据推送形式通知应用，信息变更事件参考文档信息变更事件推送 (opens new window)

支持事件

事件类型	事件	事件描述
应用可用范围信息事件	addUsableRange	新增应用可用范围信息事件
	updateUsableRange	修改应用可用范围信息事件
	deleteUsableRange	删除应用可用范围信息事件

字段申请：

发送需要申请的字段到 seasonyuan@tencent.com进行申请(邮件同时也抄送至lydiaxyang@tencent.com ， lindayyang@tencent.com ， ronniewan@tencent.com)，申请时需要注明申请内容、应用APPKEY、应用名称、及应用使用场景

请求方法：

POST(application/json)

请求地址：

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

组织架构信息事件

请求参数：

{
    "app_key": "APP_KEY",
    "school_code":"1042163732",
    "event":"updateUsableRange",
    "raw_data": "..."
}

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

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

{
    "school_code":"1042163732",
    "auth_info":{
        "auth_identity":[
            110,
            111,
            112
        ],
        "auth_org":[
            326,
            327,
        ],
        "auth_tag":[
            337,
            350
        ],
        "auth_role":[
            10010,
            10016
        ],
        "auth_user":[
            "a1234",
            "a1235"
        ]
    },
    "updated_at":"2021-09-29 18:12:08"
}

参数	必填	类型	实例	说明
school_code	是	String	1042163732	主体的编号
updated_at	是	String	2021-09-29 18:12:08	更新时间
auth_identity	否	Array	[110,111,112]	用户身份类型
auth_org	否	Array	[326,327]	组织架构id
auth_tag	否	Array	[337,350]	用户标签id
auth_role	否	Array	[10010,10016]	用户角色id
auth_user	否	Array	["a1234","a1235"]	用户电子卡号/学工号

响应说明：

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

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

注意事项

1. 签名算法

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

2. 加密算法

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

KEY = APP_KEY
IV = APP_SECRET 前16位

3. 成员身份类型 每个主体都可以自定义成员身份类型，获取成员身份类型列表，参考文档获取成员身份类型