文档中心 > API类目 > 钉钉API

dingtalk.oapi.workspace.auditlog.list (查询项目中文件操作日志)

获取钉钉项目空间任务中文件的操作日志列表

公共参数

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://gw.api.taobao.com/router/rest	https://eco.taobao.com/router/rest

名称	类型	是否必须	描述
access_token	String	是	钉钉提供的授权Token，想了解详情，ISV开发者请点击这里，企业开发者请点击这里。若有疑问，咨询邮箱dingding_open_dingtalk#list.alibaba-inc.com。

请求参数

名称	类型	是否必须	示例值	描述
start_date	Number	必须	1604160000000	操作日志起始时间，unix时间戳，单位ms
end_date	Number	必须	1606665600000	操作日志截止时间，unix时间戳，单位ms
page_size	Number	必须	500	操作列表长度，最大500
load_more_gmt_create	Number	可选	1605369600000	操作记录生成时间，作为分页偏移量，分页查询时必传，unix时间戳，单位ms
load_more_bizId	Number	可选	22	操作记录文件id，作为分页偏移量，与load_more_gmt_create一起使用，返回记录的biz_id为load_more_biz_id且gmt_create为load_more_gmt_create之后的操作列表，分页查询获取下一页时，传最后一条记录的biz_id和gmt_create。

响应参数

名称	类型	示例值	描述
errcode	Number	0	错误码
errmsg	String	成功	错误信息
result	OpenAuditLogDto		返回值
log_list EventAuditLogDto [] 记录列表 └ receiver_name String 总经理办公室文件接收方名称 └ gmt_create String 1577601221260 记录修改时间，unix时间戳，单位ms └ org_name String 测试企业企业名称 └ project_name String 测试项目项目名称 └ task_name String 测试任务任务名称 └ resource_extension String docx 文件类型 └ resource_size String 1024 文件大小 └ resource String test.docx 文件名 └ action String 上传文件操作类型 └ browser String Chrome 操作机器浏览器 └ ip_address String 1.1.1.1 操作机器ip └ platform String MacOs 操作端 └ operator_name String 测试操作者名字 └ ding_talk_id String 12345676 用户的钉钉id └ emp_id String 12344 用户所在企业中的员工id └ biz_id String 111 文件id

请求示例

JAVA
.NET
PHP
CURL
Python
C/C++
NodeJS

DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/workspace/auditlog/list");
OapiWorkspaceAuditlogListRequest req = new OapiWorkspaceAuditlogListRequest();
req.setStartDate(1604160000000L);
req.setEndDate(1606665600000L);
req.setPageSize(500L);
req.setLoadMoreGmtCreate(1605369600000L);
req.setLoadMoreBizId(22L);
OapiWorkspaceAuditlogListResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

IDingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/workspace/auditlog/list");
OapiWorkspaceAuditlogListRequest req = new OapiWorkspaceAuditlogListRequest();
req.StartDate = 1604160000000L;
req.EndDate = 1606665600000L;
req.PageSize = 500L;
req.LoadMoreGmtCreate = 1605369600000L;
req.LoadMoreBizId = 22L;
OapiWorkspaceAuditlogListResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

include "TopSdk.php";
date_default_timezone_set('Asia/Shanghai');

$c = new DingTalkClient(DingTalkConstant::$CALL_TYPE_OAPI, DingTalkConstant::$METHOD_POST , DingTalkConstant::$FORMAT_JSON);
$req = new OapiWorkspaceAuditlogListRequest;
$req->setStartDate("1604160000000");
$req->setEndDate("1606665600000");
$req->setPageSize("500");
$req->setLoadMoreGmtCreate("1605369600000");
$req->setLoadMoreBizId("22");
$resp = $c->execute($req, "https://oapi.dingtalk.com/topapi/workspace/auditlog/list");

curl -X POST "https://oapi.dingtalk.com/topapi/workspace/auditlog/list" \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'access_token=d09f5ac8-ba54-4018-b578-fbdb1c0fac87' \
-d 'end_date=1606665600000' \
-d 'load_more_bizId=22' \
-d 'load_more_gmt_create=1605369600000' \
-d 'page_size=500' \
-d 'start_date=1604160000000'

# -*- coding: utf-8 -*-
import dingtalk.api

req=dingtalk.api.OapiWorkspaceAuditlogListRequest("https://oapi.dingtalk.com/topapi/workspace/auditlog/list")

req.start_date=1604160000000
req.end_date=1606665600000
req.page_size=500
req.load_more_gmt_create=1605369600000
req.load_more_bizId=22
try:
	resp= req.getResponse()
	print(resp)
except Exception,e:
	print(e)

pTopRequest pRequest = alloc_top_request();
pTopResponse pResponse = NULL;
pTaobaoClient pClient = alloc_taobao_client(url, appkey, appsecret);
set_api_name(pRequest,"dingtalk.oapi.workspace.auditlog.list");
add_param(pRequest,"start_date","1604160000000");
add_param(pRequest,"end_date","1606665600000");
add_param(pRequest,"page_size","500");
add_param(pRequest,"load_more_gmt_create","1605369600000");
add_param(pRequest,"load_more_bizId","22");
pResponse = top_execute(pClient,pRequest,NULL);
printf("ret code:%d\n",pResponse->code);
if(pResponse->code == 0){
	pTopResponseIterator ite = init_response_iterator(pResponse);
	pResultItem pResultItem = alloc_result_item();
	while(parseNext(ite, pResultItem) == 0){
		printf("%s:%s\n",pResultItem->key,pResultItem->value);
	}
	destroy_response_iterator(ite);
	destroy_result_item(pResultItem);
}
destroy_top_request(pRequest);
destroy_top_response(pResponse);
destroy_taobao_client(pClient);

TopClient = require('./topClient').TopClient;
var client = new TopClient({
	'appkey': 'appkey',
	'appsecret': 'secret',
	'REST_URL': 'http://gw.api.taobao.com/router/rest'
});

client.execute('dingtalk.oapi.workspace.auditlog.list', {
	'start_date':'1604160000000',
	'end_date':'1606665600000',
	'page_size':'500',
	'load_more_gmt_create':'1605369600000',
	'load_more_bizId':'22'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

响应示例

JSON示例

{
    "errcode":0,
    "errmsg":"成功",
    "result":{
        "log_list":[
            {
                    "receiver_name":"总经理办公室",
                    "gmt_create":"1577601221260",
                    "org_name":"测试企业",
                    "project_name":"测试项目",
                    "task_name":"测试任务",
                    "resource_extension":"docx",
                    "resource_size":"1024",
                    "resource":"test.docx",
                    "action":"上传文件",
                    "browser":"Chrome",
                    "ip_address":"1.1.1.1",
                    "platform":"MacOs",
                    "operator_name":"测试",
                    "ding_talk_id":"12345676",
                    "emp_id":"12344",
                    "biz_id":"111"
            }
        ]
    }
}

异常示例

JSON示例

{
	"errcode":88,
	"errmsg":"ding talk error"
}

错误码解释

错误码	错误描述	解决方案

API工具

API测试工具错误码查询工具 SDK下载

如何获得此API

FAQ

我要提问

返回
顶部

开放平台

钉钉API

dingtalk.oapi.workspace.auditlog.list (查询项目中文件操作日志)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ