腾讯微卡主动拉取成员变更列表_办公协同解决方案
接口描述
只有主体对应用处于开启状态时，应用方才能调通本文档中接口拿到该主体相关数据。该接口用于获取成员增 量更新数据，业务方根据自身的需要，按照时间区间进行获取。本接口对于更新区间限制比较严格，请查看注意事项。
请求方法
POST（application/json）
请求地址
https://open.wecard.qq.com/cgi-bin/user/get-update-records
输入参数
| 参数名称 | 参数描述 | 参数类型 | 是否必填 | 备注 |
| access_token | 应用有效凭证 | String | 是 | 通过获取应用有效凭证接口获取 |
| range_start | 获取增量更新开始区间 | Datetime | 是 | 默认为当天0点（开始时间与结束时间需在同一天范围内） |
| range_end | 获取增量更新开始区间 | Datetime | 是 | 默认为当前时间（开始时间与结束时间需在同一天范围内） |
| page | 分页页数 | Integer | 是 | 默认为1 |
| page_size | 分页条数 | Integer | 是 | 默认为1000，最大为1000 |
输出参数
| 参数名称 | 参数描述 | 参数类型 | 是否必填 | 备注 |
| errcode | 状态码 | Integer | 是 | 0：成功，非0：错误 |
| errmsg | 状态描述信息 | String | 是 | – |
| page | 当前获取数据为第几页 | Integer | 是 | – |
| page_size | 当前获取数据的页大小 | Integer | 是 | – |
| range_start | 获取增量更新开始区间，默认为当天0点 | Datetime | 否 | – |
| range_end | 获取增量更新结束区间，默认为当前时间 | Datetime | 否 | – |
| total | 该组织架构下所有的用户总数 | Integer | 是 | – |
| list | 成员变更列表 | List | 是 | – |
| list.type | 数据变更类型 | String | 是 | addUser：新增updateUser：修改deleteUser：删除 |
| list.card_number | 用户学工号 | String(32) | 是 | – |
| list.created_at | 事件发生时间 | Datetime | 是 | 2019-12-04 09:00:00 |
示例
输入示例
{ "access_token":"XAyFh03UemERYTDzl0GtPpGQ4BDBkJEJ", "range_start":"2020-11-1 00:00:00", "range_end":"2020-11-1 23:59:59", "page":1, "page_size":1000}
输出示例
{ "errcode":0, "errmsg":"ok", "page":1, "page_size":1000, "range_start":"2020-11-1 00:00:00", "range_end":"2020-11-1 23:59:59", "total":606, "list":[ { "type":"updateUser", "card_number":"20181818", "created_at":"2020-11-01 12:03:03" } ]}
说明私有化部署的主体不能使用上面接口地址，需要根据主体私有化部署域名拼上对应的路径。增量数据具有时效性，过期的增量数据没有过多的意义，本接口限制最多仅能获取一天前的数据。增联更新开始时间和结束时间必须要为同一天。
对腾讯微卡的解决方案有疑惑？想了解解决方案收费？ 联系解决方案专家
腾讯云限时活动1折起，即将结束： 马上收藏
同尘科技为腾讯云授权服务中心，购买腾讯云享受折上折，更有现金返利:同意关联，立享优惠
阿里云解决方案也看看？： 点击对比阿里云的解决方案
