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 }
      }
    ]
  }
}

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.

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 }
      }
    ]
  }
}