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

dingtalk.oapi.cspace.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	必须	1577340931837	操作日志起始时间，unix时间戳，单位ms
end_date	Number	必须	1577945731837	操作日志截止时间，unix时间戳，单位ms
page_size	Number	必须	500	操作列表长度，最大500
load_more_gmt_create	Number	可选	1577340931837	操作记录生成时间，作为分页偏移量，分页查询时必传，unix时间戳，单位ms
load_more_biz_id	Number	可选	6406817113	操作记录文件id，作为分页偏移量，与load_more_gmt_create一起使用，返回记录的biz_id为load_more_biz_id且gmt_create为load_more_gmt_create之后的操作列表，分页查询获取下一页时，传最后一条记录的biz_id和gmt_create。

响应参数

名称	类型	示例值	描述
result	ListAuditLogResult		结果
list AuditLogVO [] 记录列表 └ gmt_modified Number 1577601221260 记录修改时间，unix时间戳，单位ms └ operate_module Number 2 操作来源空间 └ operate_module_view String 企业群操作来源翻译值 └ biz_id String 11258620701 文件id └ operator_name String 测试用户昵称 └ platform Number 11 操作端 └ platform_view String WIN 操作端翻译值 └ status Number 0 记录状态 └ action Number 0 操作类型 └ action_view String 上传文件操作类型翻译值 └ resource String test.docx 文件名 └ gmt_create Number 1577601221260 记录生成时间，unix时间戳，单位ms └ userid String 123234443 员工的userId └ ip_address String 1.1.1.1 操作机器ip └ org_name String 水果公司文件所属组织名称 └ receiver_name String 总经理办公室文件接收方名称 └ receiver_type_view String 单聊接收方类型翻译值 └ receiver_type Number 0 文件接收方类型 └ resource_extension String doc 文件类型 └ resource_size Number 1024 文件大小 └ target_space_id Number 11258620 空间id └ real_name String 张三用户姓名 doc_member_info_list DocMemberInfoVo [] 文档授权成员列表，仅授权文档操作有效 └ member_name String 张三成员名称 └ member_type Number 2 成员类型 └ member_type_view String 用户成员类型翻译值 └ permission_role Number 1 权限角色 └ permission_role_view String 阅读者权限角色预览 doc_receiver_list DocReceiverVo [] 文档分享成员列表，仅分享文档时有效 └ receiver_name String 测试群成员名称 └ receiver_type Number 1 成员类型 └ receiver_type_view String 群聊成员类型翻译值
success	Boolean	true	请求结果
errcode	Number	0	错误码
errmsg	String	成功	错误信息

请求示例

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

DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/cspace/auditlog/list");
OapiCspaceAuditlogListRequest req = new OapiCspaceAuditlogListRequest();
req.setStartDate(1577340931837L);
req.setEndDate(1577945731837L);
req.setPageSize(500L);
req.setLoadMoreGmtCreate(1577340931837L);
req.setLoadMoreBizId(6406817113L);
OapiCspaceAuditlogListResponse rsp = client.execute(req, access_token);
System.out.println(rsp.getBody());

IDingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/cspace/auditlog/list");
OapiCspaceAuditlogListRequest req = new OapiCspaceAuditlogListRequest();
req.StartDate = 1577340931837L;
req.EndDate = 1577945731837L;
req.PageSize = 500L;
req.LoadMoreGmtCreate = 1577340931837L;
req.LoadMoreBizId = 6406817113L;
OapiCspaceAuditlogListResponse rsp = client.Execute(req, access_token);
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 OapiCspaceAuditlogListRequest;
$req->setStartDate("1577340931837");
$req->setEndDate("1577945731837");
$req->setPageSize("500");
$req->setLoadMoreGmtCreate("1577340931837");
$req->setLoadMoreBizId("6406817113");
$resp = $c->execute($req, $access_token, "https://oapi.dingtalk.com/topapi/cspace/auditlog/list");

curl -X POST "https://oapi.dingtalk.com/topapi/cspace/auditlog/list" \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'access_token=b9aa4f0f-b349-47d0-9233-725772e9b18e' \
-d 'end_date=1577945731837' \
-d 'load_more_biz_id=6406817113' \
-d 'load_more_gmt_create=1577340931837' \
-d 'page_size=500' \
-d 'start_date=1577340931837'

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

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

req.start_date=1577340931837
req.end_date=1577945731837
req.page_size=500
req.load_more_gmt_create=1577340931837
req.load_more_biz_id=6406817113
try:
	resp= req.getResponse(access_token)
	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.cspace.auditlog.list");
add_param(pRequest,"start_date","1577340931837");
add_param(pRequest,"end_date","1577945731837");
add_param(pRequest,"page_size","500");
add_param(pRequest,"load_more_gmt_create","1577340931837");
add_param(pRequest,"load_more_biz_id","6406817113");
pResponse = top_execute(pClient,pRequest,sessionKey);
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.cspace.auditlog.list', {
	'start_date':'1577340931837',
	'end_date':'1577945731837',
	'page_size':'500',
	'load_more_gmt_create':'1577340931837',
	'load_more_biz_id':'6406817113'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

响应示例

JSON示例

{
    "result":{
        "list":[
            {
                    "gmt_modified":1577601221260,
                    "operate_module":2,
                    "operate_module_view":"企业群",
                    "biz_id":"11258620701",
                    "operator_name":"测试",
                    "platform":11,
                    "platform_view":"WIN",
                    "status":0,
                    "action":0,
                    "action_view":"上传文件",
                    "resource":"test.docx",
                    "gmt_create":1577601221260,
                    "userid":"123234443",
                    "ip_address":"1.1.1.1",
                    "org_name":"水果公司",
                    "receiver_name":"总经理办公室",
                    "receiver_type_view":"单聊",
                    "receiver_type":0,
                    "resource_extension":"doc",
                    "resource_size":1024,
                    "target_space_id":11258620,
                    "real_name":"张三",
                    "doc_member_info_list":[
                        {
                                "member_name":"张三",
                                "member_type":2,
                                "member_type_view":"用户",
                                "permission_role":1,
                                "permission_role_view":"阅读者"
                        }
                    ],
                    "doc_receiver_list":[
                        {
                                "receiver_name":"测试群",
                                "receiver_type":1,
                                "receiver_type_view":"群聊"
                        }
                    ]
            }
        ]
    },
    "success":true,
    "errcode":0,
    "errmsg":"成功"
}

异常示例

JSON示例

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

错误码解释

错误码	错误描述	解决方案

API工具

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

如何获得此API

FAQ

我要提问

返回
顶部

开放平台

钉钉API

dingtalk.oapi.cspace.auditlog.list (获取企业文件操作日志)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ