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

1. 简介

1.1 接口简介

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

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

1.2 版本说明

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

1.3 接口版本

接口版本	更新时间	版本说明
v1	2026.05.28	原始接口
v2	2026.06.29	新增响应字段： daily_automation_exec：智能助手 Pro 日执行次数 daily_attachment_upload：日附件上传量

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：数据总量 daily_automation_exec：智能助手 Pro 日执行次数 daily_attachment_upload：日附件上传量，单位：byte

响应示例：

{
  "date": "2026-06-29",
  "metrics": {
    "app": 34,
    "form_coop": 245,
    "form_workflow": 109,
    "dash": 75,
    "etl": 52,
    "aggregate": 29,
    "public_link": 0,
    "data_trigger": 100,
    "automation": 43,
    "bpa": 0,
    "data": 353,
    "daily_attachment_upload": 0,
    "daily_automation_exec": 0
  }
}