查询服务群活跃用户
GET
/v1.0/serviceGroup/groups/queryActiveUsers最后修改时间:: 2 年前
责任人: 未设置
说明
调用本接口获取指定服务群内近期活跃的用户。
服务地址:api.dingtalk.com
权限
要调用此API,需要以下权限之一。
应用类型 | 是否支持 | 权限 | API Explorer调试 |
---|---|---|---|
企业内部应用 | 支持 | 场景服务群读写权限 | API Explorer |
第三方企业应用 | 暂不支持 | 场景服务群读写权限 | 暂不支持 |
第三方个人应用 | 暂不支持 | 场景服务群读写权限 | 暂不支持 |
错误码
HttpCode | 错误码 | 错误信息 | 说明 |
---|---|---|---|
400 | illegalPama | 参数非法 | 参数非法 |
500 | systemError | 系统异常 | 系统异常 |
请求参数
Query 参数
openTeamId
string
开放团队ID。
openConversationId
string
群ID。
Header 参数
x-acs-dingtalk-access-token
string
必需
调用该接口的访问凭证。如何获取不同应用的凭证请参考访问凭证概述。
Body 参数application/json
object {0}
示例
{}
示例代码
返回响应
成功(200)
HTTP 状态码: 200
内容格式: JSONapplication/json
数据结构
activeUserInfos
array [object {7}]
活跃用户列表。
unionId
string
可选
用户unionId。
nickName
string
昵称。
actionIndexL7d
object
可选
最近一周的行为指数。
actionIndexL14d
object
可选
最近二周的行为指数。
actionIndexL30d
object
可选
最近一个月的行为指数。
activeScore
object
活跃度。
ranking
integer
排名。
示例
{
"activeUserInfos": [
{
"unionId": "string",
"nickName": "string",
"actionIndexL7d": {},
"actionIndexL14d": {},
"actionIndexL30d": {},
"activeScore": {},
"ranking": 0
}
]
}
最后修改时间: 2 年前