Skip to main content
GET
网站分析
string
必填
你账户的 API 密钥。你可以在账户设置中找到它。
网站分析会聚合应用默认 squareweb.app 域名及任何已绑定自定义域名的 Cloudflare 边缘流量:请求数、带宽、访客数,以及按国家、设备、操作系统、浏览器、协议、方法、路径、来源(referer)和客户端网络的细分。你可以用它构建流量仪表盘,或在不拉取原始请求日志的情况下发现异常模式。 结果按 5 分钟为一个桶进行缓存;缓存未命中会计入每个所有者每 60 秒 10 次请求的限制,因此反复轮询同一时间窗口的成本很低。最大回溯窗口为 7 天,实际起始时间会被限制到不早于应用的创建日期。与 网络日志网络性能 不同,此端点在所有付费套餐上均可用,而不仅限于 Pro 和 Enterprise。 如果需要的是聚焦错误而非整体流量的数据,请参见 网络错误。要在部署后清除缓存的边缘响应,请参见 清除缓存

参数

string
必填
应用的 ID。你可以在应用控制面板的 URL 中找到它。
string
必填
分析时间窗口的 ISO 8601 起始时间戳。最大保留窗口为 7 天;起始时间会被限制到不早于应用的创建日期。
string
必填
ISO 8601 结束时间戳。必须晚于 start

下钻筛选器

可选的筛选器,用于将每一项分类明细缩窄至匹配的流量。请回填此前响应中对应分类明细返回的确切 type 值。多个筛选器以“与”(AND)方式组合。
string
单个客户端国家(2 位字符代码),如 countries 分类明细中所返回。
string
单个客户端 IP(精确匹配 IPv4/IPv6),如 ips 分类明细中所返回。
string
以该前缀开头的请求路径(例如 /api 覆盖 /api/*)。最多 256 个字符。
string
单个边缘响应状态码(3 位数字),如 status_codes 分类明细中所返回。
string
单个客户端操作系统,如 os 分类明细中所返回。
string
单个客户端浏览器,如 browsers 分类明细中所返回。
string
单个 HTTP 协议,如 protocols 分类明细中所返回。
string
单个来源(referer)主机,如 referers 分类明细中所返回(Direct = 无来源)。
string
单个客户端网络,如 providers 分类明细中所返回,例如 GOOGLE (15169)、纯 ASN 编号或 SQUARE-CLOUD-PLATFORM
string
单个响应内容类型,如 content_types 分类明细中所返回(Unknown = 未分类)。
string
单个已验证的机器人类别,如 bots 分类明细中所返回(Unverified = 常规的非机器人流量)。

响应

该路由可以以压缩格式发送响应,从而优化数据传输。
string
指示调用是否成功。成功时为 success,否则为 error
object
每一项分类明细都是一个桶(bucket)数组。type 标识维度,visits 是独立访客数,requests 是请求数,bytes 是所服务的响应字节数,date 是 15 分钟窗口的起始时间。ipsstatus_codesbotscontent_types 这几项分类明细为窗口总计(整个窗口内的 top-N),且date 字段。当请求的窗口起始时间早于应用的创建日期时,返回一个空对象({})。

常见错误