Skip to main content
本页的 endpoint 仅适用于网站应用 —— 即带有 web 域名的应用。对非网站应用调用它们会失败。

自定义域名

api.SetApplicationCustomDomain(appID, domain) 设置绑定到网站的自定义域名。

DNS 记录

绑定自定义域名后,你需要在域名注册商处配置 DNS。api.GetApplicationDNS(appID)[]squarecloud.DNSRecord 返回需要创建的记录。

分析

api.GetApplicationAnalytics(appID, start, end)squarecloud.NetworkAnalytics 返回给定时间窗口内聚合的边缘分析数据。时间窗口是必需的,最大保留期为 7 天
响应包含 15 分钟粒度的时间序列(VisitsCountriesDevicesOSBrowsersProtocolsMethodsPathsReferersProviders)和整个窗口的聚合桶(IPsStatusCodesBotsContentTypes)。
对于完全早于应用创建时间的窗口,API 返回一个空对象 —— 响应中的每个切片都是 nil。索引前请先检查长度。

下钻筛选

除时间窗口外,该 endpoint 还接受作为查询参数的可选筛选条件 —— 使用 rest.WithQueryParam 传入。每个筛选条件会同时收窄响应中的每一项细分数据:

错误追踪

api.GetApplicationNetworkErrors(appID, start, end) 返回边缘错误的细分数据。默认只包含 5xx 错误 —— 添加 include_4xx=true 以包含 4xx。

逐请求日志

api.GetApplicationNetworkLogs(appID, start, end) 返回边缘的逐请求日志。
逐请求日志需要 Pro 套餐或更高级别。

延迟百分位

api.GetApplicationNetworkPerformance(appID, start, end) 返回边缘层和源站层的 p50 / p95 / p99 延迟。
性能指标需要 Pro 套餐或更高级别。

清除边缘缓存

api.PurgeApplicationCache(appID) 使应用域名的整个边缘缓存失效。

账户级域名与负载均衡器

以下两个方法作用于账户中的所有应用,而非单个网站。

列出所有域名

api.GetApplicationDomains()[]squarecloud.AppDomain 返回账户所有应用中配置的每一个域名。自定义域名排在前面;没有 web 域名的应用会被省略。

负载均衡器

api.GetLoadBalancers() 将共享同一自定义域名的应用分组,返回一个 squarecloud.LoadBalancers
包含 2 个或更多应用的分组就是一个活跃的负载均衡器:流量在边缘进行均衡,当其中一个应用离线时自动故障转移。Limit 是账户套餐允许共享同一域名的最大应用数量:2(Standard)、5(Pro)、10(Enterprise)。