获取成员资源用量统计接口

1. 简介

1.1 接口简介

获取当前企业在指定日期的成员维度资源用量统计。

1.2 版本说明

本功能为付费高级功能，简道云旗舰版、独享版可用，其他版本请联系销售增购。详情参见：官网定价。

1.3 接口版本

接口版本	更新时间	版本说明
v1	2026.05.28	原始接口

2. 接口调用

请求地址：https://api.jiandaoyun.com/api/v1/corp_usage/member_metrics

请求频率：1 次/秒

请求方式：POST

请求参数：

参数	类型	必需	说明
date	String	否	统计日期，格式 yyyy-MM-dd。不传或传空字符串表示查询当前日期的前一日（T-1）的统计信息
member_ids	String[]	否	成员 ID 列表，最多 10 个。空数组或不传表示分页查询全部成员
skip	Number	否	分页偏移，默认 0
limit	Number	否	分页大小，默认 20，最大 100

注：

1）date 默认为东八区时间，即中国时间。

2）指定 date 时，不能晚于当前日期的前一日（T-1），最多支持查询最近 180 天。

3）使用该接口时，若从未使用过「管理后台＞＞管理工具＞>使用统计」功能，将无法获取相关数据，指标字段返回值为 0。

4）当 date 合法但传入时间早于第一次使用「管理后台 >> 管理工具 >> 使用统计」功能时，也无法获取相关数据

请求示例：

{
  "date": "2026-05-08",
  "member_ids": [
    "65f000000000000000000011"
  ],
  "skip": 0,
  "limit": 20
}

响应参数：

参数	含义
date	统计日期。
has_next	是否存在下一页
items	成员统计列表
items[].member	成员基础信息
items[].member.member_id	成员 ID
items[].member.name	成员名称
items[].metrics	成员维度指标。指标字段如下所示： app：应用数； form_coop：普通表单数； form_workflow：流程表单数； dash：仪表盘数； etl：数据工厂数； aggregate：聚合表数； public_link：外链开启数； data_trigger：智能助手数； automation：智能助手 Pro 数； bpa：流程分析数； data：数据总量

响应示例：

{
  "date": "2026-05-08",
  "has_next": false,
  "items": [
    {
      "member": {
        "member_id": "65f000000000000000000011",
        "name": "张三"
      },
      "metrics": {
        "app": 2,
        "form_coop": 10,
        "form_workflow": 1,
        "dash": 3,
        "etl": 1,
        "aggregate": 0,
        "public_link": 2,
        "data_trigger": 1,
        "automation": 1,
        "bpa": 0
      }
    }
  ]
}