登录
基础
连接微信
办公
企业内部开发 服务端API 安全管理 文件防泄漏
文件防泄漏
最后更新：2023/11/30
启用了 “文件防泄漏”的企业可以通过本接口查询文件上传、下载、转发等操作记录。
请求方式：POST（HTTPS）
请求地址: https://qyapi.weixin.qq.com/cgi-bin/security/get_file_oper_record?access_token=ACCESS_TOKEN
请求包体
{
"start_time": 166666666,
"end_time": 166666667,
"userid_list": ["zhangsan", "lisi"],
"operation": {
"type": 103,
"source":401
},
"cursor":"ngLgjieajgieo",
"limit":100
}参数说明
| 参数 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
| access_token | string | 是 | 应用调用凭证 |
| start_time | int | 是 | 开始时间 |
| end_time | int | 是 | 结束时间，开始时间到结束时间的范围不能超过14天 |
| userid_list | array | 否 | 需要查询的文件操作者的userid，单次最多可以传100个用户 |
| operation | object | 否 | 参考Operation结构说明 |
| cursor | string | 否 | 由企业微信后台返回，第一次调用可不填 |
| limit | int | 否 | 限制返回的条数，最多设置为1000 |
调用说明
- 调用的应用需要满足如下的权限：
| 应用类型 | 权限要求 |
|---|---|
| 自建应用 | 配置到「文件防泄漏 - 可调用接口的应用」中 |
| 代开发应用 | 暂不支持 |
| 第三方应用 | 暂不支持 |
注： 从2023年12月1日0点起，不再支持通过系统应用secret调用接口，存量企业暂不受影响 查看详情
- 已产生的操作记录将永久保存
应用可见范围外用户相关的数据会被过滤掉，不会返回
返回示例
{
"errcode": 0,
"errmsg": "ok",
"has_more": true,
"next_cursor": "gejMjgLjgeigoejg",
"record_list": [{
"time": 16666666666,
"userid": "zhangsan",
"operation": {
"type": 101,
"source": 401
},
"file_info": "1234567890.jpg"
}, {
"time": 16666666666,
"external_user":{
"type":2,
"name":"xxx",
"corp_name":"十分科技"
},
"operation": {
"type": 10001
},
"file_info": "通过zhangsan的链接下载了1234567890.jpg",
"applicant_name":"张三"
},{
"time": 16666666666,
"userid":"lisi",
"operation": {
"type": 103,
"source":401
},
"file_info": "通过zhangsan的链接下载了1234567890.jpg",
"device_type":1,
"device_code":"owM2ovo"
}]
}参数说明
| 参数 | 类型 | 说明 |
|---|---|---|
| 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.external_user | object | 企业外部人员账号信息，参考ExternalUser结构说明，当操作者为企业外部用户时返回该结构 |
| record_list.operation | object | 参考Operation结构说明 |
| record_list.file_info | string | 文件操作说明 |
| record_list.applicant_name | string | 当记录操作类型为『通过下载申请』或者『拒绝下载申请』时，该字段表示申请人的名字 |
| record_list.device_type | int | 设备类型 1-企业可信设备 2-个人可信设备 仅当操作类型为『下载』时会返回 |
| record_list.device_code | string | 设备编码。仅当操作类型为『下载』时会返回 |
Operation结构说明
| 参数 | 类型 | 说明 |
|---|---|---|
| type | int | 操作类型，101：上传；102：新建文件夹；103：下载；104：更新；105：星标；106：移动；107：复制；108：重命名；109：删除；110：恢复；111：彻底删除；112：转发到企业微信；113：通过链接下载；114：获取分享链接；115：修改分享链接；116：关闭分享链接；117：收藏；118：新建文档；119：新建表格；121：打开；124：导出文件；127：添加文件成员；128：修改文件成员权限；129：移除文件成员；130：设置文档水印；131：修改企业内权限；132：修改企业外权限；133：添加快捷入口；134：转发到微信；135：预览；136：权限管理；139：安全设置；140：通过邮件分享；142：离职成员文件转交；10001：通过下载申请；10002：拒绝下载申请； |
| source | int | 操作来源，在操作类型为“上传”或者“下载”时，可以通过改字段细分操作来源。401：聊天；402：邮件；403：文档；404：微盘；405：日程 |
ExternalUser结构说明
| 参数 | 类型 | 说明 |
|---|---|---|
| type | int | 用户类型，1：微信用户；2：企业微信用户 |
| name | string | 用户名 |
| corp_name | string | 当用户为企业微信用户时，返回该字段 |
- 文件防泄漏
本节内容
