> ## 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.
# 网络性能
> 获取应用的边缘与源站延迟百分位数，并按国家、colo 和路径进行细分。
返回应用在某个时间窗口内的边缘与源站响应时间百分位数（`p50`、`p95`、`p99`），以及按国家、按 colo 和最慢路径的细分。适用于诊断延迟劣化并识别哪些路由或区域最慢。
仅在 **Pro** 和 **Enterprise** 套餐可用。缓存未命中速率限制：每个所有者每 60 秒 10 个请求。
你账户的 API 密钥。你可以在[账户设置](https://squarecloud.app/zh/account/security)中找到它。
### 参数
应用的 ID。你可以在应用控制面板的 URL 中找到它。
分析窗口的 ISO 8601 起始时间戳。
ISO 8601 结束时间戳。必须晚于 `start`。
### 响应
指示调用是否成功。成功时为 `success`，否则为 `error`。
该窗口的延迟百分位数与细分。
整个窗口的聚合延迟百分位数。
边缘侧延迟百分位数，单位为毫秒。
第 50 百分位（中位数）边缘延迟。
第 95 百分位边缘延迟。
第 99 百分位边缘延迟。
源站侧延迟百分位数，单位为毫秒。
第 50 百分位（中位数）源站延迟。
第 95 百分位源站延迟。
第 99 百分位源站延迟。
该窗口内分析的请求总数。
在分析窗口内按时段分桶的延迟百分位数。
分桶起始时间戳，ISO 8601 格式。
该分桶中观测到的请求数。
该分桶的边缘 `p50`/`p95`/`p99`。
该分桶的源站 `p50`/`p95`/`p99`。
按客户端国家划分的延迟细分。
ISO 国家代码（例如 `BR`、`US`）。
该国家的中位延迟，单位为毫秒。
该国家的第 95 百分位延迟，单位为毫秒。
服务于该国家的请求数。
按边缘 colo（数据中心）划分的延迟细分。
Colo 标识符（例如 `GRU`、`IAD`）。
colo 所在城市。
colo 所在国家。
该 colo 的中位延迟，单位为毫秒。
该 colo 的第 95 百分位延迟，单位为毫秒。
通过该 colo 服务的请求数。
该窗口内延迟最高的路径。
请求路径。
该路径的第 95 百分位延迟，单位为毫秒。
该路径的第 99 百分位延迟，单位为毫秒。
该路径观测到的请求数。
```json theme={null}
{
"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
}
]
}
}
```