接口描述
应用接入后,开启主体下第三方应用可用范围变更事件会以数据推送形式通知应用。
支持事件
事件类型 | 事件 | 事件描述 |
应用可用范围信息事件 | addUsableRange | 新增应用可用范围信息事件 |
| updateUsableRange | 修改应用可用范围信息事件 |
| deleteUsableRange | 删除应用可用范围信息事件 |
说明
发送需要申请的字段到 zhimuli@tencent.com 进行申请(邮件同时也抄送至hongfuhuang@tencent.com,ronniewan@tencent.com),申请时需要注明申请内容、应用 APPKEY、应用名称、及应用使用场景。
请求方法
POST(application/json)
请求地址
应用在接入时,需要提供接收事件推送地址进行配置。
输入参数
参数名称 | 参数类型 | 是否必填 | 参数描述 |
app_key | String | 是 | 应用接入时分配的 key |
school_code | String | 是 | 主体的编号 |
event | String | 是 | 事件类型 |
raw_data | String | 是 | 加密数据 |
说明
其中 raw_data 为加密后的数据,解密之后如下:
raw_data 解密后字段:
参数名称 | 类型 | 是否必填 | 示例 | 参数描述 |
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 | Integer | 是 | 接收响应状态码 | 0为成功,非0时则认为接收方接受数据失败,将会进行重试 |
message | String | 是 | 接收状态补充说明 | - |
示例
输入示例
{"app_key":"APP_KEY","school_code":"1042163732","event":"updateUsableRange","raw_data":"..."}
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"}
输出示例
{"code":0,"message":"ok"}