获取应用资源用量统计接口

1. 简介

1.1 接口简介

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

1.2 版本说明

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

1.3 接口版本

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

2. 接口调用

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

请求频率：1 次/秒

请求方式：POST

请求参数：

参数	类型	必需	说明
date	String	否	统计日期，格式 yyyy-MM-dd。不传或传空字符串表示查询当前日期的前一日（T-1）的统计信息
app_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",
  "app_ids": [
    "65f000000000000000000001"
  ],
  "skip": 0,
  "limit": 20
}

响应参数：

参数	含义
date	统计日期。
has_next	是否存在下一页
items	应用统计列表
items[].app_id	应用 ID
items[].app_name	应用名称
items[].creator	创建者基础信息
items[].created_at	创建时间
items[].last_edit_at	最近一次编辑时间
items[].last_visit_at	最近一次访问时间
items[].metrics	应用维度指标。指标字段如下所示： app：应用数，应用维度通常为 1； form_coop：普通表单数； form_workflow：流程表单数； dash：仪表盘数； etl：数据工厂数； aggregate：聚合表数； public_link：外链开启数； data_trigger：智能助手数； automation：智能助手 Pro 数； bpa：流程分析数； data：数据总量

响应示例：

{
  "date": "2026-05-08",
  "has_next": false,
  "items": [
    {
      "app_id": "65f000000000000000000001",
      "app_name": "CRM",
      "creator": {
        "member_id": "65f000000000000000000011",
        "name": "张三"
      },
      "created_at": "2026-01-01T00:00:00+08:00",
      "last_edit_at": "2026-05-06T12:00:00+08:00",
      "last_visit_at": "2026-05-06T18:00:00+08:00",
      "metrics": {
        "app": 1,
        "form_coop": 20,
        "form_workflow": 3,
        "dash": 2,
        "etl": 1,
        "aggregate": 1,
        "public_link": 5,
        "data_trigger": 2,
        "automation": 1,
        "bpa": 0,
        "data": 1200
      }
    }
  ]
}