获取用户维度的用户活跃和功能使用数据

用于获取用户维度的用户活跃和功能使用数据，即IM（即时通讯）、日历、云文档、音视频会议功能的使用数据。
只有企业自建应用才有权限调用此接口

当天的数据会在第二天的早上九点半产出（UTC+8）

错误码

HTTP状态码	错误码	描述	排查建议
500	1051001	request contain invalid param	请求中包含非法参数
400	1051002	request to exceed authority	请求发生越权

curl --location --request GET 'https://open.feishu.cn/open-apis/admin/v1/admin_user_stats?user_id_type=open_id&department_id_type=department_id&start_date=2020-02-15&end_date=2020-02-15&department_id=od-382e2793cfc9471f892e8a672987654c&user_id=ou_7dab8a3d3cdcc9da365777c7ad535d62&page_size=10&page_token=2' \ --header 'Authorization;'

{ "code": 0, "msg": "success", "data": { "has_more": true, "page_token": "3", "items": [ { "date": "2020-02-15", "user_id": "ou_7dab8a3d3cdcc9da365777c7ad535d62", "user_name": "Zhang San", "department_name": "testcqlbfaaasdasdasd", "department_path": "testkkk/testcqlbfaaasdasdasd", "create_time": "2020-09-04 11:17:55", "user_active_flag": 1, "register_time": "2020-09-04 11:18:32", "suite_active_flag": 1, "last_active_time": "2020-12-21 22:21:28", "im_active_flag": 1, "send_messenger_num": 0, "docs_active_flag": 1, "create_docs_num": 1, "cal_active_flag": 1, "create_cal_num": 0, "vc_active_flag": 1, "vc_duration": 0, "active_os": "'ios 14.2,-','ios 14.2,feishu 3.40.0-alpha'", "create_task_num": 0, "vc_num": 0, "app_package_type": "Feishu，Lark", "os_name": "iOS,Andorid,Windows" } ] } }

请求参数

Query 参数

user_id_type

必需

用户 ID 类型

示例值："open_id"

可选值有：

open_id：用户的 open id
union_id：用户的 union id
user_id：用户的 user id
默认值：open_id

当值为 user_id，字段权限要求：

perm获取用户 userid

示例值:

open_id

department_id_type

必需

部门ID类型

示例值："open_department_id"

可选值有：

department_id：部门的 ID
open_department_id：部门的 Open ID

示例值:

department_id

start_date

必需

起始日期（包含），格式是YYYY-mm-dd

示例值："2020-02-15"

示例值:

2020-02-15

end_date

必需

终止日期（包含），格式是YYYY-mm-dd。起止日期之间相差不能超过31天（包含31天）示例值："2020-02-15"

示例值:

2020-02-15

department_id

必需

部门的 ID，取决于department_id_type示例值："od-382e2793cfc9471f892e8a672987654c"

示例值:

od-382e2793cfc9471f892e8a672987654c

user_id

必需

用户的open_id，user_id或者union_id，取决于user_id_type示例值："ou_7dab8a3d3cdcc9da365777c7ad535d62"

示例值:

ou_7dab8a3d3cdcc9da365777c7ad535d62

page_size

可选

分页大小，默认是10

示例值：10

数据校验规则：

取值范围：1 ～ 20

示例值:

page_token

可选

分页标记，第一次请求不填，表示从头开始遍历；当返回的has_more为true时，会返回新的page_token，再次调用接口，传入这个page_token，将获得下一页数据

示例值："2"

示例值:

Header 参数

Authorization

string

必需

tenant_access_token 或 user_access_token 值格式："Bearer access_token" 示例值："Bearer u-7f1bcd13fc57d46bac21793a18e560"

默认值:

Bearer {{access_token}}

Content-Type

string

必需

固定值："application/json; charset=utf-8"

默认值:

application/json; charset=utf-8

application/json

Body

code

integer

必需

错误码，非 0 表示失败

msg

string

错误描述

必需

data

object

必需

has_more

boolean

是否有下一页数据

必需

page_token

string

必需

下一页分页的token

items

array [object {23}]

数据报表

必需

获取用户维度的用户活跃和功能使用数据

错误码#

请求参数

返回响应

错误码