文件防泄漏 - 文档 - 企业微信开发者中心

企业内部开发

服务端API

安全管理

文件防泄漏

最后更新：2024/08/26

启用了 “文件防泄漏”的企业可以通过本接口查询文件上传、下载、转发等操作记录。

请求方式：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",
		"file_size":405842,
		"file_md5":"gmgi32jginniboamgoge"
	}, {
		"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	文件操作说明
file_md5	string	文件的MD5
file_size	int32	文件大小。单位：字节
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：日程；406：会议；407：审批；408：汇报；409：收集表；410：客户联系；411：上下游；450：收藏；451：文件列表；452：其他