Pular para o conteúdo principal
GET
Análise do website
Authorization
string
obrigatório
A chave da API para sua conta. Você pode encontrá-la nas configurações da conta.
A Análise agrega o tráfego de borda do Cloudflare para o domínio squareweb.app padrão da aplicação e qualquer domínio personalizado associado: contagem de requisições, banda, contagem de visitantes e detalhamentos por país, dispositivo, sistema operacional, navegador, protocolo, método, caminho, referer e rede do cliente. Use-a para montar dashboards de tráfego ou identificar padrões incomuns sem precisar puxar logs brutos de requisições. Os resultados ficam em cache em blocos de 5 minutos; um cache miss conta para o limite de 10 requisições a cada 60 segundos por proprietário, então fazer polling repetido da mesma janela é barato. A janela máxima de retenção é de 7 dias, e o início efetivo é limitado à data de criação da aplicação. Diferente de Logs de rede e Performance de rede, este endpoint está disponível em todos os planos pagos, não apenas Pro e Enterprise. Para tráfego focado em erros em vez de tráfego geral, veja Erros de rede. Para limpar as respostas em cache na borda após um deploy, veja Limpar cache.

Parâmetros

app_id
string
obrigatório
O ID da aplicação. Você pode encontrá-lo na URL do painel da sua aplicação.
start
string
obrigatório
Timestamp inicial em formato ISO 8601 para a janela de análise. A janela máxima de retenção é de 7 dias; o início é limitado à data de criação da aplicação.
end
string
obrigatório
Timestamp final em formato ISO 8601. Deve ser posterior ao start.

Filtros de detalhamento

Filtros opcionais que restringem todos os detalhamentos ao tráfego correspondente. Reutilize o valor type exato retornado pelo detalhamento correspondente em uma resposta anterior. Os filtros combinam entre si (E lógico).
country
string
Um único país do cliente (código de 2 caracteres), conforme retornado no detalhamento countries.
ip
string
Um único IP do cliente (correspondência exata IPv4/IPv6), conforme retornado no detalhamento ips.
path
string
Caminhos de requisição que começam com este prefixo (ex.: /api cobre /api/*). Máx. 256 caracteres.
status
string
Um único código de status de resposta da edge (3 dígitos), conforme retornado no detalhamento status_codes.
os
string
Um único sistema operacional do cliente, conforme retornado no detalhamento os.
browser
string
Um único navegador do cliente, conforme retornado no detalhamento browsers.
protocol
string
Um único protocolo HTTP, conforme retornado no detalhamento protocols.
referer
string
Um único host de referência, conforme retornado no detalhamento referers (Direct = sem referer).
provider
string
Uma única rede do cliente, conforme retornada no detalhamento providers — ex.: GOOGLE (15169), um número de ASN puro, ou SQUARE-CLOUD-PLATFORM.
content_type
string
Um único tipo de conteúdo da resposta, conforme retornado no detalhamento content_types (Unknown = não classificado).
bot
string
Uma única categoria de bot verificado, conforme retornada no detalhamento bots (Unverified = tráfego regular, não-bot).

Resposta

Esta rota pode retornar uma resposta em formato compactado, otimizando a transmissão de dados.
status
string
Indica se a chamada foi bem-sucedida. success se bem-sucedida, error se não.
response
object
Cada detalhamento é um array de buckets. type identifica a dimensão, visits é o número de visitantes únicos, requests é a contagem de requisições, bytes é o total de bytes servidos na resposta, e date é o início da janela de 15 minutos. Os detalhamentos ips, status_codes, bots e content_types são totais da janela (top-N sobre toda a janela) e não possuem o campo date. Retorna um objeto vazio ({}) quando a janela solicitada começa antes da data de criação da aplicação.

Erros comuns