POST AI agent ready /v1/site/performance

站点性能 API - TTFB、重定向和压缩检查

获取 URL 并测量首字节时间 (TTFB)、总响应时间、内容编码（gzip、brotli 或无）、重定向计数、每个跃点的重定向链、HTTP 状态代码、服务器标头和内容元数据。对于性能监控、CI/CD 门和调试缓慢的页面加载很有用。

Endpoint

curl -X POST https://api.botoi.com/v1/site/performance \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com"}'

When to use this API

每分钟轮询此端点以获取您的生产 URL。随着时间的推移跟踪 TTFB 和total_time_ms。当 TTFB 超过 SLA 阈值或 status_code 不为 200 时发出警报。

部署到暂存后调用此端点。如果 TTFB 超过 500 毫秒或禁用压缩，则管道失败。在生产之前发现性能下降。

传递 URL 并检查 redirect_chain 数组以查看每个跃点、状态代码和计时。识别增加延迟的不必要的重定向。常见的罪魁祸首：HTTP 到 HTTPS、www 到非 www 以及尾部斜杠重定向。

TTFB 测量什么？

第一个字节的时间 (TTFB) 是发送 HTTP 请求和接收响应的第一个字节之间的时间（以毫秒为单位）。它包括 DNS 解析、TCP 连接、TLS 握手和服务器处理时间。

它会执行 JavaScript 还是渲染页面？

否。此端点测量 HTTP 响应，而不是客户端渲染。它对服务器响应进行计时并检查标头。对于 JavaScript 渲染性能，请使用基于浏览器的工具，例如 Lighthouse。

请求是从哪里发送的？

请求从 Cloudflare Workers 边缘节点发送。最近的 Cloudflare 数据中心处理该请求，因此 TTFB 反映了该边缘节点与目标服务器之间的延迟。

它遵循多少个重定向？

端点最多遵循 10 次重定向。每个重定向都记录在redirect_chain数组中，包括其URL、状态代码和时间。如果链超过 10 跳，请求将失败并出现重定向循环错误。

我可以测试经过身份验证的页面吗？

否。端点发送标准 GET 请求，不带 cookie 或身份验证标头。它仅衡量可公开访问页面的性能。

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.