Análise do site

curl

curl "https://app.cubehosting.com.br/api/projects/$PROJECT_ID/analytics?window=7d" \
  -H "Authorization: Bearer $CUBE_API_KEY"

const API = 'https://app.cubehosting.com.br/api';
const headers = { Authorization: `Bearer ${process.env.CUBE_API_KEY}` };

const res = await fetch(`${API}/projects/${process.env.PROJECT_ID}/analytics?window=7d`, { headers });
const { totals, countries } = await res.json();
console.log(`${totals.requests} requisições e ${totals.visits} visitas em 7 dias`);
console.log('País que mais acessou:', countries[0]?.code ?? 'nenhum');

import os
import requests

API = "https://app.cubehosting.com.br/api"
headers = {"Authorization": f"Bearer {os.environ['CUBE_API_KEY']}"}

r = requests.get(
    f"{API}/projects/{os.environ['PROJECT_ID']}/analytics",
    params={"window": "7d"},
    headers=headers,
    timeout=30,
)
r.raise_for_status()
data = r.json()
print(f"{data['totals']['requests']} requisições e {data['totals']['visits']} visitas em 7 dias")

{
  "window": "24h",
  "intervalSeconds": 900,
  "totals": {
    "requests": 15201,
    "visits": 1479,
    "bytes": 279698400
  },
  "devices": {
    "desktop": {
      "requests": 8817,
      "visits": 680,
      "bytes": 185157000
    },
    "mobile": {
      "requests": 6384,
      "visits": 799,
      "bytes": 94483200
    }
  },
  "statusCodes": {
    "2xx": 13681,
    "3xx": 912,
    "4xx": 532,
    "5xx": 76
  },
  "responseTimeMs": {
    "p50": 38,
    "p95": 412
  },
  "points": [
    {
      "time": "2026-09-28T03:00:00.000Z",
      "requests": 120,
      "visits": 9
    },
    {
      "time": "2026-09-28T03:15:00.000Z",
      "requests": 96,
      "visits": 7
    }
  ],
  "routes": [
    {
      "path": "/",
      "requests": 4712
    },
    {
      "path": "/produtos",
      "requests": 2584
    }
  ],
  "countries": [
    {
      "code": "BR",
      "requests": 10793,
      "visits": 1050
    },
    {
      "code": "US",
      "requests": 1368,
      "visits": 133
    }
  ]
}

GET

projects

{id}

analytics

curl

curl "https://app.cubehosting.com.br/api/projects/$PROJECT_ID/analytics?window=7d" \
  -H "Authorization: Bearer $CUBE_API_KEY"

const API = 'https://app.cubehosting.com.br/api';
const headers = { Authorization: `Bearer ${process.env.CUBE_API_KEY}` };

const res = await fetch(`${API}/projects/${process.env.PROJECT_ID}/analytics?window=7d`, { headers });
const { totals, countries } = await res.json();
console.log(`${totals.requests} requisições e ${totals.visits} visitas em 7 dias`);
console.log('País que mais acessou:', countries[0]?.code ?? 'nenhum');

import os
import requests

API = "https://app.cubehosting.com.br/api"
headers = {"Authorization": f"Bearer {os.environ['CUBE_API_KEY']}"}

r = requests.get(
    f"{API}/projects/{os.environ['PROJECT_ID']}/analytics",
    params={"window": "7d"},
    headers=headers,
    timeout=30,
)
r.raise_for_status()
data = r.json()
print(f"{data['totals']['requests']} requisições e {data['totals']['visits']} visitas em 7 dias")

{
  "window": "24h",
  "intervalSeconds": 900,
  "totals": {
    "requests": 15201,
    "visits": 1479,
    "bytes": 279698400
  },
  "devices": {
    "desktop": {
      "requests": 8817,
      "visits": 680,
      "bytes": 185157000
    },
    "mobile": {
      "requests": 6384,
      "visits": 799,
      "bytes": 94483200
    }
  },
  "statusCodes": {
    "2xx": 13681,
    "3xx": 912,
    "4xx": 532,
    "5xx": 76
  },
  "responseTimeMs": {
    "p50": 38,
    "p95": 412
  },
  "points": [
    {
      "time": "2026-09-28T03:00:00.000Z",
      "requests": 120,
      "visits": 9
    },
    {
      "time": "2026-09-28T03:15:00.000Z",
      "requests": 96,
      "visits": 7
    }
  ],
  "routes": [
    {
      "path": "/",
      "requests": 4712
    },
    {
      "path": "/produtos",
      "requests": 2584
    }
  ],
  "countries": [
    {
      "code": "BR",
      "requests": 10793,
      "visits": 1050
    },
    {
      "code": "US",
      "requests": 1368,
      "visits": 133
    }
  ]
}

A mesma análise da aba Análise do painel, para montar o seu próprio painel ou um relatório. Só sites e APIs.

`window`	Bloco da linha do tempo
`24h`	15 minutos (`intervalSeconds: 900`)
`7d`	1 hora (`3600`)
`30d`	6 horas (`21600`)

Os blocos começam na meia-noite de Brasília, e points traz todos os blocos da janela, do mais velho ao de agora, com 0 onde não houve acesso. Os números ficam guardados por 30 dias.

Visita é o mesmo aparelho (endereço e navegador) uma vez por dia, contada sem cookie e sem guardar o IP; requisição é cada resposta do site.
routes traz as 20 rotas mais pedidas, sem a query; as outras requisições entram só em totals.requests.
countries usa o código ISO de 2 letras; XX quando o país não é conhecido.
responseTimeMs vai do pedido chegar até o site mandar os cabeçalhos; null sem medida no período.

Erros comuns

Código	HTTP	O que fazer
`invalid_request`	400	Use `window` com `24h`, `7d` ou `30d`.
`not_found`	404	Confira o ID do projeto.
`not_a_site`	422	O projeto é um bot: só sites e APIs têm análise.

Todos os códigos, com o formato do erro, em Códigos de erro.

Autorizações

Authorization

string

header

obrigatório

Chave de API da Cube (cube_…), criada no painel em Chaves de API. Mande como Authorization: Bearer cube_….

Parâmetros de caminho

string

obrigatório

O ID do projeto (26 caracteres). Aparece no painel, no topo do projeto, e em GET /projects.

Pattern: ^[0-9A-HJKMNP-TV-Z]{26}$

Exemplo:

"01J8Z3W6N0Q4Y7V2K5T9D1H3XA"

Parâmetros de consulta

window

enum<string>

padrão:24h

A janela de tempo.

Opções disponíveis:

24h,

7d,

30d

Resposta

O resumo da janela.

window

enum<string>

obrigatório

Opções disponíveis:

24h,

7d,

30d

intervalSeconds

integer

obrigatório

Segundos de cada bloco da linha do tempo: 900, 3600 ou 21600.

totals

object

obrigatório

Show child attributes

devices

object

obrigatório

Computador e celular, pelo User-Agent (robôs e curl contam como computador).

Show child attributes

statusCodes

object

obrigatório

Quantas respostas de cada classe. As páginas da Cube de site parado ou sem resposta contam como 503.

Show child attributes

responseTimeMs

object

obrigatório

Do pedido chegar até o site mandar os cabeçalhos. null sem medida no período.

Show child attributes

points

object[]

obrigatório

Todos os blocos da janela, do mais velho ao de agora.

Show child attributes

routes

object[]

obrigatório

As 20 rotas mais pedidas: o caminho sem a query (/login?token=x conta como /login). As outras entram só em totals.

Show child attributes

countries

object[]

obrigatório

Todos os países do período, do que mais pediu ao que menos. code é o ISO 3166 de 2 letras; XX quando o país não é conhecido.

Show child attributes

Visão geral

Projetos

Templates

Controle

Logs e métricas

Análise

Variáveis de ambiente

Backups

Versões dos envios

Bancos de dados

Blob

Domínios

Avisos

Conta

Erros comuns

Autorizações

Parâmetros de caminho

Parâmetros de consulta

Resposta

​Erros comuns

Autorizações

Parâmetros de caminho

Parâmetros de consulta

Resposta

Erros comuns