Obter Analytics do Cascade
curl --request POST \
--url https://server.codeium.com/api/v1/CascadeAnalytics \
--header 'Content-Type: application/json' \
--data '
{
"service_key": "<string>",
"group_name": "<string>",
"start_timestamp": "<string>",
"end_timestamp": "<string>",
"emails": [
{}
],
"ide_types": [
{}
],
"query_requests": [
{}
]
}
'import requests
url = "https://server.codeium.com/api/v1/CascadeAnalytics"
payload = {
"service_key": "<string>",
"group_name": "<string>",
"start_timestamp": "<string>",
"end_timestamp": "<string>",
"emails": [{}],
"ide_types": [{}],
"query_requests": [{}]
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
service_key: '<string>',
group_name: '<string>',
start_timestamp: '<string>',
end_timestamp: '<string>',
emails: [{}],
ide_types: [{}],
query_requests: [{}]
})
};
fetch('https://server.codeium.com/api/v1/CascadeAnalytics', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://server.codeium.com/api/v1/CascadeAnalytics",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'service_key' => '<string>',
'group_name' => '<string>',
'start_timestamp' => '<string>',
'end_timestamp' => '<string>',
'emails' => [
[
]
],
'ide_types' => [
[
]
],
'query_requests' => [
[
]
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://server.codeium.com/api/v1/CascadeAnalytics"
payload := strings.NewReader("{\n \"service_key\": \"<string>\",\n \"group_name\": \"<string>\",\n \"start_timestamp\": \"<string>\",\n \"end_timestamp\": \"<string>\",\n \"emails\": [\n {}\n ],\n \"ide_types\": [\n {}\n ],\n \"query_requests\": [\n {}\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://server.codeium.com/api/v1/CascadeAnalytics")
.header("Content-Type", "application/json")
.body("{\n \"service_key\": \"<string>\",\n \"group_name\": \"<string>\",\n \"start_timestamp\": \"<string>\",\n \"end_timestamp\": \"<string>\",\n \"emails\": [\n {}\n ],\n \"ide_types\": [\n {}\n ],\n \"query_requests\": [\n {}\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://server.codeium.com/api/v1/CascadeAnalytics")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"service_key\": \"<string>\",\n \"group_name\": \"<string>\",\n \"start_timestamp\": \"<string>\",\n \"end_timestamp\": \"<string>\",\n \"emails\": [\n {}\n ],\n \"ide_types\": [\n {}\n ],\n \"query_requests\": [\n {}\n ]\n}"
response = http.request(request)
puts response.read_body{
"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>"
}
]
}
}
]
}Analytics API
Obter Analytics do Cascade
Consultar métricas de uso específicas do Cascade, incluindo linhas sugeridas/aceitas, uso de modelos de IA, consumo de créditos e estatísticas de uso de ferramentas.
POST
/
api
/
v1
/
CascadeAnalytics
Obter Analytics do Cascade
curl --request POST \
--url https://server.codeium.com/api/v1/CascadeAnalytics \
--header 'Content-Type: application/json' \
--data '
{
"service_key": "<string>",
"group_name": "<string>",
"start_timestamp": "<string>",
"end_timestamp": "<string>",
"emails": [
{}
],
"ide_types": [
{}
],
"query_requests": [
{}
]
}
'import requests
url = "https://server.codeium.com/api/v1/CascadeAnalytics"
payload = {
"service_key": "<string>",
"group_name": "<string>",
"start_timestamp": "<string>",
"end_timestamp": "<string>",
"emails": [{}],
"ide_types": [{}],
"query_requests": [{}]
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
service_key: '<string>',
group_name: '<string>',
start_timestamp: '<string>',
end_timestamp: '<string>',
emails: [{}],
ide_types: [{}],
query_requests: [{}]
})
};
fetch('https://server.codeium.com/api/v1/CascadeAnalytics', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://server.codeium.com/api/v1/CascadeAnalytics",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'service_key' => '<string>',
'group_name' => '<string>',
'start_timestamp' => '<string>',
'end_timestamp' => '<string>',
'emails' => [
[
]
],
'ide_types' => [
[
]
],
'query_requests' => [
[
]
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://server.codeium.com/api/v1/CascadeAnalytics"
payload := strings.NewReader("{\n \"service_key\": \"<string>\",\n \"group_name\": \"<string>\",\n \"start_timestamp\": \"<string>\",\n \"end_timestamp\": \"<string>\",\n \"emails\": [\n {}\n ],\n \"ide_types\": [\n {}\n ],\n \"query_requests\": [\n {}\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://server.codeium.com/api/v1/CascadeAnalytics")
.header("Content-Type", "application/json")
.body("{\n \"service_key\": \"<string>\",\n \"group_name\": \"<string>\",\n \"start_timestamp\": \"<string>\",\n \"end_timestamp\": \"<string>\",\n \"emails\": [\n {}\n ],\n \"ide_types\": [\n {}\n ],\n \"query_requests\": [\n {}\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://server.codeium.com/api/v1/CascadeAnalytics")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"service_key\": \"<string>\",\n \"group_name\": \"<string>\",\n \"start_timestamp\": \"<string>\",\n \"end_timestamp\": \"<string>\",\n \"emails\": [\n {}\n ],\n \"ide_types\": [\n {}\n ],\n \"query_requests\": [\n {}\n ]\n}"
response = http.request(request)
puts response.read_body{
"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>"
}
]
}
}
]
}Visão geral
Solicitação
string
obrigatório
Sua Chave de serviço com permissões “Teams somente leitura”
string
Filtre os resultados para usuários de um grupo específico. Não pode ser usado com o parâmetro
emails.string
Horário de início no formato RFC 3339 (por exemplo,
2023-01-01T00:00:00Z)string
Horário de término no formato RFC 3339 (por exemplo,
2023-12-31T23:59:59Z)array
Array de endereços de email para filtrar os resultados. Não pode ser usado com o parâmetro
group_name.array
Filtrar por tipo de IDE. Opções disponíveis:
"editor"- Windsurf Editor"jetbrains"- Plugin do JetBrains
array
obrigatório
Array de consultas de fontes de dados a serem executadas. Cada objeto deve conter uma das fontes de dados compatíveis.
Fontes de Dados
cascade_lines
{
"cascade_lines": {}
}
day- Data no formato RFC 3339linesSuggested- Número de linhas sugeridaslinesAccepted- Número de linhas aceitas
cascade_runs
{
"cascade_runs": {}
}
day- Data no formato RFC 3339model- Nome do modelo de IA utilizadomode- Modo do Cascade (consulte os modos abaixo)messagesSent- Número de mensagens enviadascascadeId- ID único da conversapromptsUsed- Créditos consumidos (em centavos)
CONVERSATIONAL_PLANNER_MODE_DEFAULT- Modo de escritaCONVERSATIONAL_PLANNER_MODE_READ_ONLY- Modo de leituraCONVERSATIONAL_PLANNER_MODE_NO_TOOL- Modo legadoUNKNOWN- Modo desconhecido
cascade_tool_usage
{
"cascade_tool_usage": {}
}
tool- Identificador da ferramenta (consulte os mapeamentos de ferramentas abaixo)count- Número de vezes que a ferramenta foi utilizada
Mapeamentos de Uso de Ferramentas
| Tool Identifier | Nome exibido |
|---|---|
CODE_ACTION | Edição de Código |
VIEW_FILE | Visualizar Arquivo |
RUN_COMMAND | Executar Command |
FIND | Ferramenta Localizar |
GREP_SEARCH | Busca com grep |
VIEW_FILE_OUTLINE | Visualizar Estrutura do Arquivo |
MQUERY | Riptide |
WORKFLOWS_USED | Workflows usados |
LIST_DIRECTORY | Listar Diretório |
MCP_TOOL | Ferramenta MCP |
PROPOSE_CODE | Propor Código |
SEARCH_WEB | Buscar na Web |
MEMORY | Memória |
PROXY_WEB_SERVER | Pré-visualização no Navegador |
DEPLOY_WEB_APP | Implantar Aplicação Web |
Exemplo de solicitação
curl -X POST --header "Content-Type: application/json" \
--data '{
"service_key": "sua_chave_de_servico_aqui",
"group_name": "equipe_engenharia",
"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
Resposta
array
Array de resultados de consulta, um para cada solicitação de consulta
Mostrar Resultado de Cascade Lines
Mostrar Resultado de Cascade Lines
Mostrar Resultado de Cascade Runs
Mostrar Resultado de Cascade Runs
object
array
Array de estatísticas de uso do modelo de IA
string
Data no formato RFC 3339
string
Nome do modelo de IA usado para a execução
string
Identificador do modo Cascade
string
Número de mensagens enviadas
string
Identificador único da conversa
string
Créditos consumidos em centavos (por exemplo, “100” = 1 crédito)
Exemplo de resposta
{
"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"
}
]
}
}
]
}
Observações
- A API retorna dados brutos que podem conter valores “UNKNOWN”
- Para análise de métricas, agregue com base em campos específicos de interesse (por exemplo, some
promptsUsedpara identificar padrões de uso) - Os dados de modo e de prompt podem estar distribuídos em várias entradas
- O consumo de créditos (
promptsUsed) é retornado em centavos (100 = 1 crédito)