> ## Documentation Index
> Fetch the complete documentation index at: https://docs.squarecloud.app/llms.txt
> Use this file to discover all available pages before exploring further.
# Erros de rede
> Obter um resumo agregado dos erros 5xx (e opcionalmente 4xx) servidos na borda da aplicação.
Retorna contagens agregadas de erros servidos na borda da aplicação em uma janela de tempo, agrupados por código de status, intervalo temporal, caminho da requisição e método HTTP. Por padrão somente respostas 5xx são incluídas; envie `include_4xx=true` para contar também as 4xx.
Rate limit de cache miss: 15 requisições por 60 segundos por proprietário. Retorna um resumo vazio quando não há erros no período ou quando a janela é anterior à data de criação da aplicação.
A chave da API para sua conta. Você pode encontrá-la nas [configurações da conta](https://squarecloud.app/pt-br/account/security).
### Parâmetros
O ID da aplicação. Você pode encontrá-lo na URL do painel da sua aplicação.
Timestamp inicial em formato ISO 8601 para a janela de análise.
Timestamp final em formato ISO 8601. Deve ser posterior ao `start`.
Define se respostas 4xx devem ser incluídas junto das 5xx. Aceita `true` ou `false`. O padrão é `false`.
### Resposta
Indica se a chamada foi bem-sucedida. `success` se bem-sucedida, `error` se não.
Resumo agregado dos erros na janela analisada.
Totais agregados da janela.
Total de respostas de erro na janela.
Totais separados por classe de status HTTP.
Total de respostas 4xx (preenchido apenas quando `include_4xx=true`).
Total de respostas 5xx.
Quantidade de requisições agrupadas por cada código de status HTTP observado.
Código de status HTTP (ex. `502`, `504`).
Total de requisições que retornaram este status.
Contagens distribuídas em intervalos temporais ao longo da janela.
Timestamp inicial do intervalo, em formato ISO 8601.
Objeto cujas chaves são códigos de status HTTP, com a contagem observada no intervalo.
Total de erros observados no intervalo.
Caminhos que produziram mais erros na janela.
Caminho da requisição.
Método HTTP.
Total de erros para este caminho/método.
Contagens por código de status HTTP observado para este caminho/método.
Totais agregados de erros agrupados por método HTTP.
Método HTTP.
Total de erros para este método.
Contagens por código de status HTTP observado para este método.
```json theme={null}
{
"status": "success",
"response": {
"summary": {
"total": 42,
"by_class": {
"4xx": 0,
"5xx": 42
}
},
"by_status": [
{ "status": 502, "requests": 30 },
{ "status": 504, "requests": 12 }
],
"timeseries": [
{
"date": "2025-12-01T12:00:00.000Z",
"buckets": { "502": 5, "504": 2 },
"total": 7
}
],
"top_paths": [
{
"path": "/api/users",
"method": "GET",
"total": 18,
"by_status": { "502": 15, "504": 3 }
}
],
"by_method": [
{
"method": "GET",
"total": 30,
"by_status": { "502": 22, "504": 8 }
}
]
}
}
```