获取边缘错误明细
按状态码、路径、方法和时间获取边缘错误计数（GET /v2/apps//network/errors）。默认只含 5xx，include_4xx=true 可加入 4xx。
GET
/
v2
/
apps
/
{app_id}
/
network
/
errors
获取边缘错误明细
curl --request GET \
--url https://api.squarecloud.app/v2/apps/{app_id}/network/errors \
--header 'Authorization: <authorization>'import requests
url = "https://api.squarecloud.app/v2/apps/{app_id}/network/errors"
headers = {"Authorization": "<authorization>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<authorization>'}};
fetch('https://api.squarecloud.app/v2/apps/{app_id}/network/errors', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.squarecloud.app/v2/apps/{app_id}/network/errors",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: <authorization>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.squarecloud.app/v2/apps/{app_id}/network/errors"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "<authorization>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.squarecloud.app/v2/apps/{app_id}/network/errors")
.header("Authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.squarecloud.app/v2/apps/{app_id}/network/errors")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = '<authorization>'
response = http.request(request)
puts response.read_body{
"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 }
}
]
}
}
返回应用在某一时间窗口内的聚合边缘错误计数，按状态码、时间分桶、请求路径和 HTTP 方法分组。默认仅包含 5xx 响应；传入
需要具有
include_4xx=true 可同时统计 4xx 响应。
缓存未命中在 analytics、errors、logs 和 performance 这几个端点之间共享同一个限制：每个应用所有者每 60 秒 20 次请求。已缓存的响应不计入。在全平台繁忙期间，该端点可能会改为返回所请求时间窗口的最新缓存数据。当没有匹配的错误，或时间窗口早于应用的创建日期时，返回空明细。
apps:read 权限范围的 API 密钥。
由于 4xx 错误中包含扫描探测、失效链接这类由客户端引起的命中，默认会被排除；只有在确实需要这些噪音数据时，例如审计机器人流量时，才启用 include_4xx=true。5xx 状态码反映的是边缘或应用本身的问题，因此始终会被包含在内。
此端点在所有套餐上均可用，与 网站分析 相同。如果你需要的是逐请求的明细而不是聚合计数，请参见 网络日志（仅限 Pro 和 Enterprise）。如果关心的是延迟而非错误率，请参见 网络性能。
参数
string
必填
应用的 ID。你可以在应用仪表盘的 URL 中找到它。
string
必填
分析窗口的 ISO 8601 起始时间戳。
string
必填
ISO 8601 结束时间戳。必须晚于
start。string
是否在 5xx 错误之外同时包含 4xx 响应。接受
true 或 false。默认为 false。响应
string
指示调用是否成功。成功时为
success，否则为 error。object
该窗口的聚合错误明细。
显示 展开响应对象
显示 展开响应对象
object
array
array
{
"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 }
}
]
}
}
常见错误
| 代码 | HTTP | 说明 |
|---|---|---|
INVALID_TIME_RANGE | 400 | start/end 缺失、格式错误，或起止时间顺序颠倒。 |
RATE_LIMITED | 429 | 已达到缓存未命中的共享限制。请稍候重试。 |
UNABLE_TO_FETCH_ERRORS | 500 | 从边缘提供商获取错误数据失败。 |
ANALYTICS_BUSY | 503 | 边缘分析暂时繁忙；请 1 分钟后重试。 |
相关内容
- CLI：
squarecloud app network errors - SDK：
api.apps.network.errors()（JavaScript）、client.apps.network.errors()（Python）、c.Apps.Network.Errors()（Go）
⌘I
获取边缘错误明细
curl --request GET \
--url https://api.squarecloud.app/v2/apps/{app_id}/network/errors \
--header 'Authorization: <authorization>'import requests
url = "https://api.squarecloud.app/v2/apps/{app_id}/network/errors"
headers = {"Authorization": "<authorization>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<authorization>'}};
fetch('https://api.squarecloud.app/v2/apps/{app_id}/network/errors', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.squarecloud.app/v2/apps/{app_id}/network/errors",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: <authorization>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.squarecloud.app/v2/apps/{app_id}/network/errors"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "<authorization>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.squarecloud.app/v2/apps/{app_id}/network/errors")
.header("Authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.squarecloud.app/v2/apps/{app_id}/network/errors")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = '<authorization>'
response = http.request(request)
puts response.read_body{
"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 }
}
]
}
}