Skip to main content
api.apps.network 仅适用于 Web 应用。每个方法都以应用 ID 作为第一个参数。 示例使用创建客户端中的 api 客户端。appId 是你的某个应用的 ID:api.account.me() 会列出它们。

时间窗口

analytics、errors、logs 和 performance 接受 start 和 end,每个都是 ISO 8601 字符串或 Date。一个窗口最长 7 天,且 start 会被限制为不早于应用的创建日期。无效的窗口会返回 400 INVALID_TIME_RANGE。
结果以 5 分钟为单位进行缓存。这四个方法的缓存未命中共享每个账户每 60 秒 20 次请求的限制:超出后返回 429 RATE_LIMITED。

分析

network.analytics(appId, start, end, filters?) 返回流量总计和细分数据。对于没有流量的窗口返回 null。
细分维度包括 countries、devices、os、browsers、protocols、methods、paths、referers、providers、ips、status_codes、bots 和 content_types。每个分组都有 type、visits、requests 和 bytes。

过滤器

过滤器会缩小每个细分维度的范围。每个过滤器接受其对应细分维度中确切的 type 值:
无效的过滤器会返回 400 INVALID_FILTER。

错误

network.errors(appId, start, end, { include_4xx }) 返回该窗口内的 5xx 响应,设置 include_4xx: true 时还包括 4xx。对于空窗口返回 null。

请求日志

network.logs(appId, start, end) 返回单个请求,包含客户端、请求和响应的详细信息。适用于 Pro 和 Enterprise 套餐(否则返回 403 UPGRADE_REQUIRED)。

性能

network.performance(appId, start, end) 返回边缘和源站的延迟百分位数(p50、p95、p99,单位为毫秒),按国家、按位置以及最慢的路径分别统计。对于空窗口返回 null。适用于 Pro 和 Enterprise 套餐。

DNS

network.dns(appId) 返回你的自定义域名所需的 DNS 记录及其状态。没有自定义域名时返回 400 NO_CUSTOM_DOMAIN。

自定义域名

network.setDomain(appId, domain) 绑定一个自定义域名(Standard 及以上套餐)。传入 "@" 即可移除。

清除缓存

network.purgeCache(appId) 清除应用的边缘缓存。每 60 秒最多清除一次(429 KEEP_CALM)。

分析方法的错误

后续步骤

实时

实时流式获取日志和状态。

网络 API 参考

这些方法背后的 REST 端点。

用 CLI 查看边缘分析

在终端中完成同样的操作。