Obter análises de usuários ativos
curl --request GET \
--url https://server.codeium.com/api/v2beta/analytics/active-users \
--header 'Authorization: Bearer <token>'import requests
url = "https://server.codeium.com/api/v2beta/analytics/active-users"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://server.codeium.com/api/v2beta/analytics/active-users', 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/v2beta/analytics/active-users",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://server.codeium.com/api/v2beta/analytics/active-users"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://server.codeium.com/api/v2beta/analytics/active-users")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://server.codeium.com/api/v2beta/analytics/active-users")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"data": [
{
"active_users": 142
}
],
"pagination": {
"next_page_cursor": null
},
"metadata": {
"data_freshness": "2026-06-16T03:00:00.000Z",
"query_time_ms": 612,
"team_id": "team_abc123"
}
}
API de Análise
Consultar usuários ativos
Consulte o número de usuários ativos distintos da sua equipe, com granularidade temporal opcional e agrupamento por usuário.
GET
/
api
/
v2beta
/
analytics
/
active-users
Obter análises de usuários ativos
curl --request GET \
--url https://server.codeium.com/api/v2beta/analytics/active-users \
--header 'Authorization: Bearer <token>'import requests
url = "https://server.codeium.com/api/v2beta/analytics/active-users"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://server.codeium.com/api/v2beta/analytics/active-users', 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/v2beta/analytics/active-users",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://server.codeium.com/api/v2beta/analytics/active-users"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://server.codeium.com/api/v2beta/analytics/active-users")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://server.codeium.com/api/v2beta/analytics/active-users")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"data": [
{
"active_users": 142
}
],
"pagination": {
"next_page_cursor": null
},
"metadata": {
"data_freshness": "2026-06-16T03:00:00.000Z",
"query_time_ms": 612,
"team_id": "team_abc123"
}
}
Este é um endpoint v2 que usa autenticação com token Bearer e parâmetros de consulta, diferentemente da Analytics API v1, que usa chaves de serviço no corpo da requisição. Consulte Autenticação abaixo.
Este endpoint não se destina ao monitoramento de uso em tempo real. Os dados são agregados por hora e o
limite de taxa de requisições é baixo (10 requisições por hora por equipe). Use-o para relatórios periódicos e exportação em massa.
Autenticação
Este endpoint usa autenticação por token Bearer. Inclua seu token no cabeçalhoAuthorization:
Authorization: Bearer <your_token>
O que conta como um usuário ativo
Um usuário é considerado ativo em um determinado intervalo de tempo se tiver qualquer evento de cobrança nele. O campoactive_users informa o número de usuários distintos.
As contagens de usuários ativos incluem o uso do Devin CLI e do Devin Desktop. Um usuário que
esteja ativo em qualquer um deles (ou em ambos) é contabilizado apenas uma vez por intervalo de tempo.
Agrupamento e granularidade
Usegranularity e group_by para controlar o formato dos dados retornados:
- Sem granularidade nem agrupamento — retorna uma única linha com a contagem total de usuários ativos em todo o intervalo de datas
granularity=daily— cada linha inclui umtimestampno formatoYYYY-MM-DD(usuários ativos diários)granularity=monthly— cada linha inclui umtimestampno formatoYYYY-MM(usuários ativos mensais)group_by=user— retorna uma linha por usuário ativo com umuser_id; oactive_usersde cada linha é1
Diferentemente de Consultar consumo, o endpoint de usuários ativos
oferece suporte apenas a
user em group_by. Outras dimensões (model_uid, ide, os) não são válidas aqui.Paginação
Os resultados são paginados com um tamanho de página padrão de 1.000 linhas (máx. 10.000). Quando há mais resultados disponíveis, a resposta inclui umnext_page_cursor no objeto pagination. Passe-o como parâmetro de consulta page_cursor
para buscar a próxima página.
Os cursores de página expiram após 24 horas. Uma requisição de página subsequente não conta como uma nova consulta para fins do seu limite de taxa de requisições.
Limites de taxa de requisições
Este endpoint tem um limite de taxa de requisições de 10 requisições por hora por equipe. Se você exceder esse limite, o servidor retornará429 Too Many Requests com um cabeçalho Retry-After.
Paginar uma consulta anterior (seguindo um next_page_cursor) não conta para esse limite —
apenas a consulta inicial de cada relatório conta. O limite baixo reflete o fato de que este endpoint é destinado a
relatórios periódicos, não ao monitoramento de uso em tempo real.Autorizações
Uma service key com permissão Analytics Read, enviada como token Bearer no header Authorization.
Crie uma service key em Configurações da equipe, na seção "Service Keys".

