Pular para o conteúdo principal
GET
/
v2
/
apps
/
{app_id}
/
network
/
errors
Erros de Rede
curl --request GET \
  --url https://api.squarecloud.app/v2/apps/{app_id}/network/errors \
  --header 'Authorization: <authorization>'
{
  "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 }
      }
    ]
  }
}
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.

​
Request

​
Headers

​
Authorization
string
obrigatório
A chave da API para sua conta. Você pode encontrá-la nas configurações da conta.

​
Path

​
app_id
string
obrigatório
O ID da aplicação. Você pode encontrá-lo na URL do painel da sua aplicação.

​
Query

​
start
string
obrigatório
Timestamp inicial em formato ISO 8601 para a janela de análise.
​
end
string
obrigatório
Timestamp final em formato ISO 8601. Deve ser posterior ao start.
​
include_4xx
string
Define se respostas 4xx devem ser incluídas junto das 5xx. Aceita true ou false. O padrão é false.

​
Response

​
status
string
Indica se a chamada foi bem-sucedida. success se bem-sucedida, error se não.
​
response
object
Resumo agregado dos erros na janela analisada.
{
  "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 }
      }
    ]
  }
}