appkey (string, 必填): 付费后获取的 APPKEY。
strategy (string, 可选): 检测策略,可选 mobile 或 desktop,默认 mobile。
locale (string, 可选): 返回语言区域,默认 zh-CN。
categories (string, 可选): 评分类别,可选 performance、accessibility、best-practices、seo;多个值用英文逗号分隔,不传时返回全部类别。
forceRefresh (boolean, 可选): 是否重新检测并刷新结果,默认 false;false 时可优先返回近期已有检测结果。
DataStatus.RequestParameter: 本次请求的参数摘要字符串。
DataStatus.StatusCode: 接口返回状态码。
DataStatus.StatusDescription: 接口返回状态说明。
DataStatus.ResponseDateTime: 接口数据返回时间。
DataStatus.DataTotalCount: 此条件下的总数据量,一般用于分页计算。
Data.RequestedUrl: 请求检测的网页 URL。
Data.FinalUrl: 检测完成后的最终网页 URL,可能是重定向后的地址。
Data.Strategy: 本次检测使用的策略,mobile 或 desktop。
Data.Locale: 本次检测使用的语言区域。
Data.ReportVersion: 页面评分报告版本。
Data.FetchTime: 检测报告生成时间。
Data.Cached: 本次返回是否来自近期已有检测结果。
Data.Scores.Performance: 性能评分,范围 0~100,没有对应分类时返回 null。
Data.Scores.Accessibility: 可访问性评分,范围 0~100,没有对应分类时返回 null。
Data.Scores.BestPractices: 最佳实践评分,范围 0~100,没有对应分类时返回 null。
Data.Scores.Seo: SEO 评分,范围 0~100,没有对应分类时返回 null。
Data.Metrics.FirstContentfulPaintMs: 首次内容绘制耗时,单位毫秒。
Data.Metrics.LargestContentfulPaintMs: 最大内容绘制耗时,单位毫秒。
Data.Metrics.SpeedIndexMs: 速度指数,单位毫秒。
Data.Metrics.TotalBlockingTimeMs: 总阻塞时间,单位毫秒。
Data.Metrics.CumulativeLayoutShift: 累计布局偏移。
Data.SeoAudits.Title: 网页标题 SEO 审计摘要。
Data.SeoAudits.MetaDescription: 网页描述 SEO 审计摘要。
Data.SeoAudits.CrawlableAnchors: 可抓取链接审计摘要。
Data.SeoAudits.IsCrawlable: 索引可用性审计摘要。
Data.SeoAudits.Canonical: Canonical 链接审计摘要。
Data.SeoAudits.HttpStatusCode: 网页 HTTP 状态审计摘要。
Data.SeoAudits.RobotsTxt: robots.txt 审计摘要。
Data.SeoAudits.Viewport: 移动端视口配置审计摘要。
Data.TopIssues.Id: 主要待优化项 ID。
Data.TopIssues.Title: 主要待优化项标题。
Data.TopIssues.Score: 主要待优化项得分,范围 0~100,没有得分时返回 null。
Data.TopIssues.DisplayValue: 主要待优化项展示值。
200 接口正常响应: 业务状态码请结合响应体中的状态字段判断。
400 请求参数错误: 参数缺失、格式错误或非法组合。
401 鉴权失败: 缺少 APPKEY 或 APPKEY 无效。
403 无权限或额度不可用: 订单到期、权限不足或剩余额度不可用。
405 请求方法不允许: 请求方法与接口定义不匹配。
415 请求内容类型不支持: 文件上传或请求体格式不符合要求。
500 服务内部异常: 服务执行异常,请联系技术支持。
502 上游依赖异常: 上游服务响应异常或暂不可用。
100 正常返回: 可通过判断此状态码断言接口正常返回。
501 参数错误: 请检查 URL、strategy、locale、categories 等参数是否正确。
502 请求频率受限: 默认情况下,每个接口提供 10 QPS 并发能力,可满足大多数业务场景。超出当前并发能力时,网关可能返回请求频率受限;如需更高吞吐,可按需购买额外 QPS 扩展包。
503 APPKEY 权限超限或订单到期: 请前往开发者中心检查 APPKEY 状态与订单有效期。
504 APPKEY 错误: 请检查传递的 APPKEY 是否正确。
505 请求次数超出接口限制: 请检查接口剩余请求次数与配额限制。
900 接口内部响应错误: 接口服务暂时不可用,请稍后重试。
获取 performance、accessibility、best-practices、seo 四类评分,分值范围 0~100;
支持 mobile 与 desktop 两种检测策略,默认 mobile;
返回 FCP、LCP、Speed Index、TBT、CLS 等核心页面体验指标;
返回标题、描述、可抓取链接、索引可用性、Canonical、HTTP 状态、robots.txt 与 viewport 等 SEO 审计摘要;
TopIssues 返回最多 10 条主要待优化项,便于快速定位页面优化方向;
支持复用近期检测结果,forceRefresh=true 可重新检测并刷新结果;
围绕“网页性能与 SEO 评分”提供标准化能力,便于快速接入现有业务;
适合将“网页性能与 SEO 评分”结果接入业务系统、后台工具和自动化流程;
全接口支持 HTTPS(TLS v1.0 / v1.1 / v1.2 / v1.3);