跳转到主要内容
GET
/
beta
/
v2
/
enterprise
/
user-usage-analysis
curl -X GET "https://api.devin.ai/beta/v2/enterprise/user-usage-analysis?limit=10&skip=0" \
  -H "Authorization: Bearer YOUR_API_KEY"
{
  "items": [
    {
      "user_id": "user_123",
      "email": "john.doe@example.com",
      "name": "John Doe",
      "last_7_days": {
        "average_acus_per_session": 15.5,
        "total_acus_consumed": 155.0,
        "sessions_started": 10,
        "searches_started": 25
      },
      "last_30_days": {
        "average_acus_per_session": 18.2,
        "total_acus_consumed": 728.0,
        "sessions_started": 40,
        "searches_started": 95
      },
      "lifetime": {
        "average_acus_per_session": 20.5,
        "total_acus_consumed": 4100.0,
        "sessions_started": 200,
        "searches_started": 450
      }
    },
    {
      "user_id": "user_456",
      "email": "jane.smith@example.com",
      "name": "Jane Smith",
      "last_7_days": {
        "average_acus_per_session": 12.0,
        "total_acus_consumed": 60.0,
        "sessions_started": 5,
        "searches_started": 12
      },
      "last_30_days": {
        "average_acus_per_session": 14.5,
        "total_acus_consumed": 435.0,
        "sessions_started": 30,
        "searches_started": 68
      },
      "lifetime": {
        "average_acus_per_session": 16.8,
        "total_acus_consumed": 2520.0,
        "sessions_started": 150,
        "searches_started": 340
      }
    }
  ],
  "total": 45,
  "skip": 0,
  "limit": 10,
  "has_more": true,
  "next_cursor": 10
}
测试版接口 - 此接口目前处于测试阶段,未来可能发生变化。尽管我们会尽量保持向后兼容,但在改进此功能的过程中,API 结构和响应格式可能会被更新。
此接口会检索企业内所有用户的详细使用分析数据,包括 ACU 消耗模式、会话次数,以及在不同时间段(过去 7 天、过去 30 天以及自启用以来的累计周期)内的搜索活动情况。

查询参数

skip
integer
default:"0"
用于分页时需要跳过的条目数量(最小值:0)
limit
integer
default:"100"
要返回的最大条目数量(最小值:1,最大值:200)

响应

items
array
用户使用情况分析对象数组
total
integer
企业中的用户总数
skip
integer
跳过的条目数量
limit
integer
每页的最大条目数
has_more
boolean
是否还有更多条目可用
next_cursor
integer
下一页的游标(如果适用)
curl -X GET "https://api.devin.ai/beta/v2/enterprise/user-usage-analysis?limit=10&skip=0" \
  -H "Authorization: Bearer YOUR_API_KEY"
{
  "items": [
    {
      "user_id": "user_123",
      "email": "john.doe@example.com",
      "name": "John Doe",
      "last_7_days": {
        "average_acus_per_session": 15.5,
        "total_acus_consumed": 155.0,
        "sessions_started": 10,
        "searches_started": 25
      },
      "last_30_days": {
        "average_acus_per_session": 18.2,
        "total_acus_consumed": 728.0,
        "sessions_started": 40,
        "searches_started": 95
      },
      "lifetime": {
        "average_acus_per_session": 20.5,
        "total_acus_consumed": 4100.0,
        "sessions_started": 200,
        "searches_started": 450
      }
    },
    {
      "user_id": "user_456",
      "email": "jane.smith@example.com",
      "name": "Jane Smith",
      "last_7_days": {
        "average_acus_per_session": 12.0,
        "total_acus_consumed": 60.0,
        "sessions_started": 5,
        "searches_started": 12
      },
      "last_30_days": {
        "average_acus_per_session": 14.5,
        "total_acus_consumed": 435.0,
        "sessions_started": 30,
        "searches_started": 68
      },
      "lifetime": {
        "average_acus_per_session": 16.8,
        "total_acus_consumed": 2520.0,
        "sessions_started": 150,
        "searches_started": 340
      }
    }
  ],
  "total": 45,
  "skip": 0,
  "limit": 10,
  "has_more": true,
  "next_cursor": 10
}