POST AI agent ready /v1/site/performance

API de desempenho do site - TTFB, redirecionamentos e verificação de compactação

Busca um URL e mede o tempo até o primeiro byte (TTFB), tempo total de resposta, codificação de conteúdo (gzip, brotli ou nenhuma), contagem de redirecionamento, cadeia de redirecionamento com cada salto, código de status HTTP, cabeçalho do servidor e metadados de conteúdo. Útil para monitoramento de desempenho, portas CI/CD e depuração de carregamentos lentos de páginas.

Endpoint

Code examples

curl -X POST https://api.botoi.com/v1/site/performance \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com"}'

When to use this API

Painéis de monitoramento de tempo de atividade

Pesquise esse endpoint a cada minuto para obter seus URLs de produção. Acompanhe TTFB e total_time_ms ao longo do tempo. Alerte quando o TTFB exceder o limite do SLA ou quando status_code não for 200.

Portas de desempenho CI/CD

Chame esse endpoint após implantar na preparação. Falha no pipeline se o TTFB exceder 500 ms ou se a compactação estiver desabilitada. Capture regressões de desempenho antes que elas cheguem à produção.

Depuração de cadeia de redirecionamento

Passe um URL e inspecione o array redirect_chain para ver cada salto, código de status e tempo. Identifique redirecionamentos desnecessários que adicionam latência. Culpados comuns: redirecionamentos HTTP para HTTPS, www para não www e barra final.

Frequently asked questions

O que o TTFB mede?

O tempo até o primeiro byte (TTFB) é o tempo em milissegundos entre o envio da solicitação HTTP e o recebimento do primeiro byte da resposta. Inclui resolução DNS, conexão TCP, handshake TLS e tempo de processamento do servidor.

Isso executa JavaScript ou renderiza a página?

Não. Este endpoint mede a resposta HTTP, não a renderização do lado do cliente. Ele cronometra a resposta do servidor e inspeciona os cabeçalhos. Para desempenho de renderização de JavaScript, use uma ferramenta baseada em navegador como o Lighthouse.

De onde é enviada a solicitação?

As solicitações são enviadas dos nós de borda do Cloudflare Workers. O data center Cloudflare mais próximo lida com a solicitação, então o TTFB reflete a latência entre esse nó de borda e o servidor de destino.

Quantos redirecionamentos ele segue?

O endpoint segue até 10 redirecionamentos. Cada redirecionamento é registrado na matriz redirect_chain com seu URL, código de status e tempo. Se a cadeia exceder 10 saltos, a solicitação falhará com um erro de loop de redirecionamento.

Posso testar páginas autenticadas?

Não. O endpoint envia uma solicitação GET padrão sem cookies ou cabeçalhos de autenticação. Ele mede o desempenho apenas de páginas acessíveis ao público.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.