获取平台资源用量统计接口

1. 简介

1.1 接口简介

获取当前企业在指定日期的平台资源用量概览。

注：接口只返回企业维度的汇总指标，不返回应用或成员明细。

1.2 版本说明

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

1.3 接口版本

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

2. 接口调用

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

请求频率：1 次/秒

请求方式：POST

请求参数：

参数	类型	必需	说明
date	String	否	统计日期，格式 yyyy-MM-dd。不传或传空字符串表示查询当前日期的前一日（T-1）的统计信息

注：

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

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

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

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

请求示例：

{
  "date": "2026-05-08"
}

响应参数：

参数	含义
date	统计日期。
metrics	企业用量指标。指标字段如下所示： app：应用数； form_coop：普通表单数； form_workflow：流程表单数； dash：仪表盘数； etl：数据工厂数； aggregate：聚合表数； public_link：外链开启数； data_trigger：智能助手数； automation：智能助手 Pro 数； bpa：流程分析数； data：数据总量

响应示例：

{
  "date": "2026-05-08",
  "metrics": {
    "app": 10,
    "form_coop": 120,
    "form_workflow": 20,
    "dash": 15,
    "etl": 5,
    "aggregate": 3,
    "public_link": 30,
    "data_trigger": 8,
    "automation": 6,
    "bpa": 2,
    "data": 50000
  }
}