> ## 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.
# 网络错误
> 获取应用的 5xx（以及可选的 4xx）边缘错误的聚合明细。
返回应用在某一时间窗口内的聚合边缘错误计数，按状态码、时间分桶、请求路径和 HTTP 方法分组。默认仅包含 5xx 响应；传入 `include_4xx=true` 可同时统计 4xx 响应。
缓存未命中速率限制：每个所有者每 60 秒 15 次请求。当没有匹配的错误，或时间窗口早于应用的创建日期时，返回空明细。
你账户的 API 密钥。你可以在[账户设置](https://squarecloud.app/zh/account/security)中找到它。
### 参数
应用的 ID。你可以在应用仪表盘的 URL 中找到它。
分析窗口的 ISO 8601 起始时间戳。
ISO 8601 结束时间戳。必须晚于 `start`。
是否在 5xx 错误之外同时包含 4xx 响应。接受 `true` 或 `false`。默认为 `false`。
### 响应
指示调用是否成功。成功时为 `success`，否则为 `error`。
该窗口的聚合错误明细。
该窗口的高层级总计。
窗口内错误响应的总数。
按 HTTP 状态类别拆分的总计。
4xx 响应总数（仅在 `include_4xx=true` 时填充）。
5xx 响应总数。
按观测到的每个单独 HTTP 状态码分组的请求数量。
HTTP 状态码（例如 `502`、`504`）。
返回此状态码的请求总数。
分析窗口内按时间分桶的计数。
分桶起始时间戳，ISO 8601 格式。
以 HTTP 状态码为键、该分桶内观测计数为值的对象。
该分桶内观测到的错误总数。
在该窗口内产生最多错误的路径。
请求路径。
HTTP 方法。
此路径/方法的错误总数。
此路径/方法下观测到的各 HTTP 状态码计数。
按 HTTP 方法分组的聚合错误总数。
HTTP 方法。
此方法的错误总数。
此方法下观测到的各 HTTP 状态码计数。
```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 }
}
]
}
}
```