腾讯微卡获取成员变更事件推送_办公协同解决方案
接口描述
应用接入后，成员变更事件会以数据推送形式通知应用。说明发送需要申请的字段到 zhimuli@tencent.com 进行申请（邮件同时也抄送至hongfuhuang@tencent.com，ronniewan@tencent.com），申请时需要注明申请内容、应用 APPKEY、应用名称、及应用使用场景。
支持事件
| 事件类型 | 事件 | 事件描述 |
| 用户信息事件 | addUser | 新增用户信息事件 |
| | updateUser | 修改用户信息事件 |
| | deleteUser | 删除用户信息事件 |
请求方法
POST（application/json）
请求地址
应用在接入时，需要提供接收事件推送地址进行配置。
输入参数
| 参数名称 | 参数描述 | 参数类型 | 是否必填 | 备注 |
| app_key | 应用接入时分配的key | String | 是 | – |
| school_code | 主体的编号 | String | 是 | – |
| event | 事件类型 | String | 是 | – |
| raw_data | 加密数据 | String | 是 | raw_data为加密后的数据 |
解密参数
说明其中 raw_data 为加密后的数据，解密之后为下面表格。加密算法采用 AES 对称加密算法（AES/CBC/ZeroPadding 128位模式），具体算法请参见 加解密。
| 参数名称 | 是否必填 | 参数类型 | 示例 | 参数描述 |
| card_number | 是 | String(32) | 07302590 | 用户学工号 |
| name | 是 | Integer | 陈小明 | 用户姓名 |
| identity_type | 是 | Integer | 1 | 成员身份类型，参见文档 成员身份类型列表 |
| grade | 否 | String | 2016 | 年级（需申请） |
| college | 否 | String | 人居环境工程学院 | 学院（需申请） |
| profession | 否 | String | 工程造价 | 专业（需申请） |
| class | 否 | String | 1班 | 班级（需申请） |
| identity_title | 否 | String | 本科生 | 身份职称（需申请） |
| gender | 否 | Integer | 1 | 性别（需申请）。0：未知1：男2：女 |
| organization | 否 | Array | [2,222,496] | 用户所属组织架构 ID 列表（需申请） |
| role | 否 | Array | [1,2] | 用户所属角色 ID 列表（需申请） |
| campus | 否 | String | 东校区 | 校区（需申请） |
| dorm_number | 否 | String | 至善园6号 | 宿舍号（需申请） |
| physical_chip_number | 否 | String | xaqwecf | 物理芯片号（需申请） |
| physical_card_number | 否 | String | fqweasd | 物理卡号（需申请） |
| nation | 否 | String | 汉族 | 民族（需申请） |
| birthday | 否 | String | 20020319 | 生日（需申请） |
| origin_place | 否 | String | 深圳市 | 生源地（需申请） |
| graduated_school | 否 | String | 小碧中学 | 毕业学校（需申请） |
| address | 否 | String | 广东省深圳市 | 地址（需申请） |
| contact_person | 否 | String | 陈大明 | 联系人姓名（需申请） |
| contact_phone | 否 | String | (+86)13800138000 | 联系人手机号码（带区号）（需申请） |
| 否 | String | 605135612@qq.com | 用户邮箱（需申请） | |
| id_card | 否 | String | 440305200203194013 | 身份证（需申请） |
| telephone | 否 | String | (+86)13800138000 | 手机号码（带区号）（需申请） |
| bind_status | 否 | Integer | 0 | 绑定状态（需申请） |
| frozen_status | 否 | Integer | 0 | 冻结状态（需申请） |
| active_status | 否 | Integer | 0 | 激活状态（需申请） |
| start_at | 否 | Datatime | 2019-10-14 00:00:00 | 有效起始时间（需申请） |
| entrust_status | 是 | Integer | 0 | 签约状态（需申请）。0：未签约1：已签约 |
| expire_at | 否 | Datatime | 2019-10-18 00:00:00 | 有效结束时间（需申请） |
| updated_at | 否 | Datatime | 2019-10-16 00:00:00 | 用户信息变更时间（需申请） |
| head_image | 否 | String | /2024/01/02/a.png | 用户头像（需申请) |
| serial_number | 否 | String | 19527123 | 编号（需申请) |
| job_title | 否 | String | 经理 | 职务（需申请) |
输出参数
| 参数名称 | 参数描述 | 参数类型 | 是否必填 | 备注 |
| code | 接收响应状态码 | Integer | 是 | 0为成功，非0时则认为接收方接受数据失败，将会进行重试 |
| message | 接收状态补充说明 | String | 是 | – |
示例
输入示例
{ "app_key":"APP_KEY", "school_code":"1011789061", "event":"addUser", "raw_data":"..."}
raw_data 字段解密结果：
{ "card_number":"07302590", "name":"陈小明", "identity_type":"1", "grade":"2016", "college":"人居环境工程学院", "profession":" 工程造价", "class":"1班", "identity_title":"本科生", "gender":1, "organization":[ 2, 222, 496 ], "role":[ 1, 2 ], "campus":"东校区", "dorm_number":"至善园", "physical_chip_number":"xaqwecf", "physical_card_number":"fqweasd", "nation":"汉族", "birthday":"20020319", "origin_place":"深圳市", "graduated_school":"小碧中学", "address":"广东省深圳市", "contact_person":"陈大明", "contact_phone":"(+86)13800138000", "email":"605135612@qq.com", "id_card":"440305200203194013", "telephone":"(+86)13800138000", "bind_status":0, "frozen_status":0, "active_status":0, "entrust_status":0, "start_at":"2019-10-14 00:00:00", "expire_at":"2019-10-18 00:00:00", "updated_at":"2019-10-16 00:00:00", "head_image":"/2024/01/02/a.png", "serial_number":"19527123", "job_title":"经理"}
输出示例
{ "code":0, "message":"ok"}
对腾讯微卡的解决方案有疑惑？想了解解决方案收费？ 联系解决方案专家
腾讯云限时活动1折起，即将结束： 马上收藏
同尘科技为腾讯云授权服务中心，购买腾讯云享受折上折，更有现金返利:同意关联，立享优惠
阿里云解决方案也看看？： 点击对比阿里云的解决方案
