登录
基础
连接微信
办公启用了 “截屏/录屏管理”的企业可以通过本接口查询截屏操作记录。
请求方式：POST（HTTPS）
请求地址: https://qyapi.weixin.qq.com/cgi-bin/security/get_screen_oper_record?access_token=ACCESS_TOKEN
请求包体
{
"start_time": 166666666,
"end_time": 166666667,
"userid_list": ["zhangsan", "lisi"],
"department_id_list" : [2, 3],
"screen_shot_type": 1,
"cursor":"ngLgjieajgieo",
"limit":100
}参数说明
| 参数 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
| access_token | string | 是 | 应用调用凭证 |
| start_time | int | 是 | 开始时间 |
| end_time | int | 是 | 结束时间，开始时间到结束时间的范围不能超过14天 |
| userid_list | array | 否 | 需要查询的截屏操作者的userid，单次最多可以传100个用户。设置的userid需要在应用的可见范围内 |
| department_id_list | array | 否 | 需要查询的截屏操作者部门的department_id，单次最多可以传100个部门id。设置的department_id需要在应用的可见范围内 |
| screen_shot_type | int | 否 | 截屏内容的类型，不设置默认为全部 1: 聊天 2: 通讯录 3: 邮件 4: 文件 5: 日程 6: 其他 |
| cursor | string | 否 | 由企业微信后台返回，第一次调用可不填 |
| limit | int | 否 | 限制返回的条数，最多设置为1000 |
调用说明
| 应用类型 | 权限要求 |
|---|---|
| 自建应用 | 配置到「截屏/录屏管理 - 可调用接口的应用」中 |
| 代开发应用 | 暂不支持 |
| 第三方应用 | 暂不支持 |
返回结果中应用可见范围外用户相关的数据会被过滤掉，不会返回返回示例
{
"errcode": 0,
"errmsg": "ok",
"has_more": true,
"next_cursor": "gejMjgLjgeigoejg",
"record_list": [{
"time": 16666666666,
"userid": "zhangsan",
"department_id": 2,
"screen_shot_type": 1,
"screen_shot_content": "聊天",
"system": "iPad"
}, {
"time": 16666666666,
"userid": "lisi",
"department_id": 3,
"screen_shot_type": 4,
"screen_shot_content": "文件（防泄露文件：test.pdf）",
"system": "iOS"
}, {
"time": 1788164413,
"userid": "12345678i90-",
"department_id": 1,
"screen_shot_type": 6,
"screen_shot_content": "其他",
"system": "other",
"operation_type": 2,
"device_info": {
"platform": "Mac",
"device_code": "FR2LXK6W7J417b370e3e2642849748a181459b1e76",
"device_model": "Mac16,7",
"mac": {
"mac_addr": ["36:99:71:2a:29:40", "36:99:71:2a:29:44", "36:99:71:2a:29:48", "4a:e8:d7:80:a3:ca", "4a:e8:d7:80:a3:cb", "4a:e8:d7:80:a3:cc", "4a:e8:d7:80:a3:ea", "4a:e8:d7:80:a3:eb", "4a:e8:d7:80:a3:ec", "84:2f:57:a1:10:48"],
"seq_no": "FR2LXK6W7J"
}
},
"ip": "14.22.11.188(广州市)"
}]
}参数说明
| 参数 | 类型 | 说明 |
|---|---|---|
| errcode | int32 | 错误码 |
| errmsg | string | 错误码说明 |
| has_more | bool | 是否还有更多数据 |
| next_cursor | string | 仅has_more值为true时返回该字段，下一次调用将该值填到cursor字段，以实现分页查询 |
| record_list.time | int | 操作时间 |
| record_list.userid | string | 企业用户账号id |
| record_list.department_id | int | 企业用户部门id。仅当department_id在应用可见范围内才返回 |
| record_list.screen_shot_type | int | 截屏内容的类型 1: 聊天 2: 通讯录 3: 邮件 4: 文件 5: 日程 6: 其他 |
| record_list.screen_shot_content | string | 截屏内容 |
| record_list.system | string | 企业用户的操作系统，目前支持返回的类型：iOS、iPad |
| record_list.operation_type | int | 操作类型 0：截屏 1：录屏 |
| record_list.device_info | object | 设备信息，详见DeviceInfo |
| record_list.ip | string | 设备IP和地址 |
DeviceInfo
| 参数 | 类型 | 说明 |
|---|---|---|
| platform | string | 设备的平台类型， Windows，Mac 或者 Mobile |
| device_code | string | 设备的唯一标识 |
| device_model | string | 设备型号 |
| windows | object | Windows设备信息，当system=Windows时返回，详见WindowsDevice |
| mac | object | Mac设备信息，当system=Mac时返回，详见MacDevice |
| mobile | object | Mobile设备信息，当system=Mobile时返回，详见MobileDevice |
WindowsDevice
| 参数 | 类型 | 说明 |
|---|---|---|
| mac_addr | string[] | mac地址列表 |
| harddisk_uuid | string[] | 硬盘序列号列表 |
| motherboard_uuid | string | 主板uuid |
| domain | string | 域名 |
| pc_name | string | 计算机名 |
MacDevice
| 参数 | 类型 | 说明 |
|---|---|---|
| mac_addr | string[] | mac地址列表 |
| seq_no | string | 序列号 |
MobileDevice
| 参数 | 类型 | 说明 |
|---|---|---|
| type | int | 设备类型 0：未知 1：安卓设备 2：iOS设备 3：iPad设备 4： 安卓平板设备 5：鸿蒙设备 6：鸿蒙平板设备 |
基础连接微信办公基础连接微信办公基础连接微信办公