> ## 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.
# 网络日志
> 获取应用各域名的逐请求边缘日志。
返回应用主域名及任何已配置的自定义域名的逐请求边缘日志（HTTP、国家/地区、状态、字节数）。最大保留窗口为 7 天；起始时间会被限制到应用的创建日期。
仅在 **Pro** 和 **Enterprise** 套餐上可用。缓存未命中速率限制：每个所有者每 60 秒 10 次请求。
你账户的 API 密钥。你可以在[账户设置](https://squarecloud.app/zh/account/security)中找到它。
### 参数
应用的 ID。你可以在应用仪表盘的 URL 中找到它。
ISO 8601 起始时间戳。不能早于应用的创建日期，也不能早于 7 天前。
ISO 8601 结束时间戳。必须晚于 `start`。
### 响应
指示调用是否成功。成功时为 `success`，否则为 `error`。
响应的内容。
请求的时间戳，ISO 格式。
发起请求的客户端的相关信息。
客户端的 IP 地址。
客户端的国家/地区代码。
客户端的大致位置。
客户端的 ASN。
客户端的 user agent。
客户端类别（例如 bot、human）。
传入请求的相关信息。
该请求是否被边缘防护措施拦截。
使用的 HTTP 方法。
Host 头的值。
请求路径。
查询字符串。
使用的协议（例如 HTTP/2）。
Referer 头的值。
在边缘处提供的响应的相关信息。
返回的 HTTP 状态码。
响应内容类型。
缓存状态（例如 HIT、MISS）。
```json theme={null}
{
"status": "success",
"response": [
{
"timestamp": "2025-12-01T12:00:00.000Z",
"client": {
"ip": "203.0.113.45",
"country": "BR",
"location": "São Paulo",
"asn": "12345 - Example ISP",
"agent": "Mozilla/5.0",
"category": null
},
"request": {
"mitigated": false,
"method": "GET",
"host": "my-app.squareweb.app",
"path": "/api/users",
"query": "?limit=10",
"protocol": "HTTP/2",
"referer": null
},
"response": {
"status": 200,
"contentType": "application/json",
"cache": "MISS"
}
}
]
}
```