查询登录使用统计

接口说明

面向政企版租户开放使用统计-连接维度 业务逻辑:支持查看时间段内云电脑用户登录数据统计,信息包括:登录次数、登录总时长、平均登录时长、最长登录时长,支持分页查询(单页默认10,最大50)。 限流:根据租户实现用户级别的限流,限制为100次每秒


推荐使用API Explorer调试

API Explorer支持接口在线可视化调用,同时自动生成动态代码示例,搭配OpenAPI SDK无需计算签名实现接口快速集成。

URL

POST https://ecloud.10086.cn/api/Computer_api/cem_openapi/ccacem/api/v1/operation/loginUsageStatistics/page

请求参数

Body

参数名称
类型
必填
描述
loginUsageStatReqDto
CcempLoginUsageStatReqDto
是

loginUsageStatReqDto

userName
string
否

用户名

orgIdList
<string> array
否

组织id列表

startTime
string
是

开始时间

endTime
string
是

结束时间

page
integer(int32)
是

当前页

pageSize
integer(int32)
是

分页大小

请求示例

POST https://ecloud.10086.cn/api/Computer_api/cem_openapi/ccacem/api/v1/operation/loginUsageStatistics/page
{
	"orgIdList":[
		"1660107282021801986"
	],
	"startTime":"2025-04-08 00:00:00",
	"endTime":"2025-04-14 23:59:59",
	"page":"1",
	"pageSize":"2"
}

返回参数

返回码:200
OK
参数名称
类型
描述
body
CcempLoginUsageStatRespDto
records
<LoginStatisticsInfo> array

使用统计数据列表

avgLoginTime
string

平均登录时长

companyCode
string

厂商

companyName
string

厂商名称

latestLoginTime
string

最近一次登录时间

loginCount
integer(int64)

登录次数

longestLoginTime
string

最长登录时长

mopUserId
string

租户Id

mopUserName
string

所属租户(展示租户名称字段)

orgId
string

组织id

orgName
string

组织名称

tenantId
string

租户id

totalLoginTime
string

登录总时长

userId
string

用户Id

userName
string

登录账号

total
integer(int32)

总数据数

errorCode
string
errorMessage
string
requestId
string
state
enum(OK,ERROR,EXCEPTION,FORBIDDEN,REMAINING,TIMEOUT)

返回示例

返回码:200
OK
{
	"state":"OK",
	"body":{
		"records":[
			{
				"userName":"test0326.aamctt",
				"userId":"1904770543451230210",
				"orgId":null,
				"orgName":"csy_saas_test",
				"mopUserName":"csy_saas_test",
				"mopUserId":"CIDC-U-abcdefghijklmnopkrstuvw123456002",
				"tenantId":"2",
				"companyCode":null,
				"companyName":"企业测试",
				"loginCount":26,
				"totalLoginTime":"83小时20分",
				"avgLoginTime":"3小时12分",
				"latestLoginTime":"2025-04-11 17:29:53",
				"longestLoginTime":"52小时23分"
			},
			{
				"userName":"test0226d.aamctt",
				"userId":"1894578187810840578",
				"orgId":null,
				"orgName":"csy_saas_test",
				"mopUserName":"csy_saas_test",
				"mopUserId":"CIDC-U-abcdefghijklmnopkrstuvw123456002",
				"tenantId":"2",
				"companyCode":null,
				"companyName":"企业测试",
				"loginCount":1,
				"totalLoginTime":"13分",
				"avgLoginTime":"13分",
				"latestLoginTime":"2025-04-11 10:01:23",
				"longestLoginTime":"13分"
			}
		],
		"total":6
	},
	"errorCode":"200",
	"errorMessage":"",
	"requestId":"22f3707670500b45"
}
本文档内容整理自移动云官方帮助中心(查看原文),仅供参考。