跳转到主要内容
POST
/
api
/
v1
/
CascadeAnalytics
获取 Cascade 分析数据
curl --request POST \
  --url https://server.codeium.com/api/v1/CascadeAnalytics \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "service_key": "<string>",
  "group_name": "<string>",
  "start_timestamp": "<string>",
  "end_timestamp": "<string>",
  "emails": [
    {}
  ],
  "ide_types": [
    {}
  ],
  "query_requests": [
    {}
  ]
}
'
{
  "queryResults": [
    {
      "cascadeLines": {
        "cascadeLines": [
          {
            "day": "<string>",
            "linesSuggested": "<string>",
            "linesAccepted": "<string>"
          }
        ]
      },
      "cascadeRuns": {
        "cascadeRuns": [
          {
            "day": "<string>",
            "model": "<string>",
            "mode": "<string>",
            "messagesSent": "<string>",
            "cascadeId": "<string>",
            "promptsUsed": "<string>"
          }
        ]
      },
      "cascadeToolUsage": {
        "cascadeToolUsage": [
          {
            "tool": "<string>",
            "count": "<string>"
          }
        ]
      }
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.devinenterprise.com/llms.txt

Use this file to discover all available pages before exploring further.

​
概述

获取 Cascade 特有的分析数据，包括建议和采纳的代码行数、模型用量、额度消耗以及工具用量统计。

​
请求

​
service_key
string
必填
具有“Teams 只读”权限的服务密钥
​
group_name
string
将结果筛选为特定组中的用户。不能与 emails 参数同时使用。
​
start_timestamp
string
开始时间，采用 RFC 3339 格式 (例如 2023-01-01T00:00:00Z)
​
end_timestamp
string
结束时间，采用 RFC 3339 格式 (例如 2023-12-31T23:59:59Z)
​
emails
array
用于筛选结果的电子邮件地址数组。不能与 group_name 参数同时使用。
​
ide_types
array
按 IDE 类型筛选。可用选项：
  • "editor" - Devin Desktop Editor
  • "jetbrains" - JetBrains Plugin
  • "cli" - Devin CLI
如果省略，则返回所有 IDE 的数据。
按 Devin CLI ("cli") 筛选时，只有 cascade_runs 会返回数据。cascade_lines 和 cascade_tool_usage 数据源不支持 Devin CLI，因此会返回空结果。
​
query_requests
array
必填
要执行的数据源查询数组。每个对象都应包含一个受支持的数据源。

​
数据源

​
cascade_lines

查询 Cascade 每日建议及已接受的代码行数。 
{
  "cascade_lines": {}
}
响应字段：
  • day - RFC 3339 格式的日期
  • linesSuggested - 建议的代码行数
  • linesAccepted - 已接受的代码行数

​
cascade_runs

查询模型用量、额度消耗和模式数据。 
{
  "cascade_runs": {}
}
响应字段：
  • day - RFC 3339 格式的日期
  • model - 所使用的模型名称
  • mode - Cascade 模式 (参见下方模式说明)
  • messagesSent - 已发送的消息数
  • cascadeId - 唯一对话 ID
  • promptsUsed - 已消耗的额度 (单位：美分)
Cascade 模式：
  • CONVERSATIONAL_PLANNER_MODE_DEFAULT - 编写模式
  • CONVERSATIONAL_PLANNER_MODE_READ_ONLY - 只读模式
  • CONVERSATIONAL_PLANNER_MODE_NO_TOOL - 旧版模式
  • UNKNOWN - 未知模式

​
cascade_tool_usage

查询工具用量统计 (汇总计数) 。 
{
  "cascade_tool_usage": {}
}
响应字段：
  • tool - 工具标识符 (参见下方的工具映射)
  • count - 工具使用的次数

​
工具用量映射

工具标识符显示名称
CODE_ACTION代码编辑
VIEW_FILE查看文件
RUN_COMMAND运行命令
FIND查找工具
GREP_SEARCHGrep 搜索
VIEW_FILE_OUTLINE文件大纲
MQUERYRiptide
WORKFLOWS_USED所用工作流程
LIST_DIRECTORY列出目录
MCP_TOOLMCP 工具
PROPOSE_CODE建议代码
SEARCH_WEB搜索 Web
MEMORY记忆
PROXY_WEB_SERVERBrowser 预览
DEPLOY_WEB_APP部署 Web 应用

​
请求示例

curl -X POST --header "Content-Type: application/json" \
--data '{
  "service_key": "your_service_key_here",
  "group_name": "engineering_team",
  "start_timestamp": "2025-01-01T00:00:00Z",
  "end_timestamp": "2025-01-02T00:00:00Z",
  "emails": ["user1@windsurf.com", "user2@windsurf.com"],
  "ide_types": ["editor"],
  "query_requests": [
    {
      "cascade_lines": {}
    },
    {
      "cascade_runs": {}
    },
    {
      "cascade_tool_usage": {}
    }
  ]
}' \
https://server.codeium.com/api/v1/CascadeAnalytics

​
响应

​
queryResults
array
查询结果数组，每个查询请求对应一个结果

​
响应示例

{
  "queryResults": [
    {
      "cascadeLines": {
        "cascadeLines": [
          {
            "day": "2025-05-01T00:00:00Z",
            "linesSuggested": "206",
            "linesAccepted": "157"
          },
          {
            "day": "2025-05-02T00:00:00Z",
            "linesSuggested": "16"
          }
        ]
      }
    },
    {
      "cascadeRuns": {
        "cascadeRuns": [
          {
            "day": "2025-05-01T00:00:00Z",
            "model": "Claude 3.7 Sonnet (Thinking)",
            "mode": "CONVERSATIONAL_PLANNER_MODE_DEFAULT",
            "messagesSent": "1",
            "cascadeId": "0d35c1f7-0a85-41d0-ac96-a04cd2d64444"
          }
        ]
      }
    },
    {
      "cascadeToolUsage": {
        "cascadeToolUsage": [
          {
            "tool": "CODE_ACTION",
            "count": "15"
          },
          {
            "tool": "LIST_DIRECTORY",
            "count": "20"
          }
        ]
      }
    }
  ]
}

​
注意事项

  • API 返回原始数据，其中可能包含 "UNKNOWN" 值
  • 进行指标分析时，请按关注的特定字段聚合 (例如，对 promptsUsed 求和以分析用量模式)
  • 模式和提示数据可能会分散在多个条目中
  • 额度消耗 (promptsUsed) 以分为单位返回 (100 = 1 积分)