Pular para o conteúdo principal
GET
/
v2
/
apps
/
{app_id}
/
network
/
performance
Performance de Rede
curl --request GET \
  --url https://api.squarecloud.app/v2/apps/{app_id}/network/performance \
  --header 'Authorization: <authorization>'
{
  "status": "success",
  "response": {
    "summary": {
      "edge": { "p50": 42, "p95": 180, "p99": 320 },
      "origin": { "p50": 28, "p95": 150, "p99": 280 },
      "requests": 12450
    },
    "timeseries": [
      {
        "date": "2025-12-01T12:00:00.000Z",
        "requests": 540,
        "edge": { "p50": 41, "p95": 175, "p99": 310 },
        "origin": { "p50": 27, "p95": 148, "p99": 270 }
      }
    ],
    "countries": [
      { "type": "BR", "p50": 35, "p95": 160, "requests": 8200 },
      { "type": "US", "p50": 55, "p95": 210, "requests": 3100 }
    ],
    "colos": [
      {
        "type": "GRU",
        "city": "São Paulo",
        "country": "BR",
        "p50": 34,
        "p95": 158,
        "requests": 8100
      }
    ],
    "slowest_paths": [
      {
        "path": "/api/reports/generate",
        "p95": 820,
        "p99": 1500,
        "requests": 230
      }
    ]
  }
}
Retorna percentis de tempo de resposta na borda e na origem (p50, p95, p99) para a aplicação em uma janela de tempo, além de detalhamento por país, por colo (data center) e pelos caminhos mais lentos. Útil para diagnosticar regressões de latência e identificar quais rotas ou regiões estão mais lentas.
Disponível apenas nos planos Pro e Enterprise. Rate limit de cache miss: 10 requisições por 60 segundos por proprietário.

​
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.

​
Response

​
status
string
Indica se a chamada foi bem-sucedida. success se bem-sucedida, error se não.
​
response
object
Percentis de latência e detalhamentos para a janela analisada.
{
  "status": "success",
  "response": {
    "summary": {
      "edge": { "p50": 42, "p95": 180, "p99": 320 },
      "origin": { "p50": 28, "p95": 150, "p99": 280 },
      "requests": 12450
    },
    "timeseries": [
      {
        "date": "2025-12-01T12:00:00.000Z",
        "requests": 540,
        "edge": { "p50": 41, "p95": 175, "p99": 310 },
        "origin": { "p50": 27, "p95": 148, "p99": 270 }
      }
    ],
    "countries": [
      { "type": "BR", "p50": 35, "p95": 160, "requests": 8200 },
      { "type": "US", "p50": 55, "p95": 210, "requests": 3100 }
    ],
    "colos": [
      {
        "type": "GRU",
        "city": "São Paulo",
        "country": "BR",
        "p50": 34,
        "p95": 158,
        "requests": 8100
      }
    ],
    "slowest_paths": [
      {
        "path": "/api/reports/generate",
        "p95": 820,
        "p99": 1500,
        "requests": 230
      }
    ]
  }
}