快速回答
如何知道 WebReaderAPI 是否正常工作？
用你的密钥调用 GET https://webreaderapi.com/api/v1/credits：这是免费的，正常返回即表示 API 和你的密钥都正常。如果页面读取失败，错误代码会告诉你原因，而且 WebReaderAPI 对此不收费。我方的故障会连同日期记录在更新日志中。
最快的健康检查是什么？
积分端点。它无需抓取任何网站即可返回，因此只测试我方：身份验证、API 和你的账户。
curl -s https://webreaderapi.com/api/v1/credits -H "Authorization: Bearer $WEBREADER_API_KEY"
哪些错误来自网站，哪些来自我们？
错误代码说明了问题所在。这些错误都不会消耗积分。
| 代码 | 问题所在 | 该怎么做 |
|---|---|---|
blocked_by_robots | 网站的 robots.txt 拒绝我们的爬虫 | 无需操作：网站已表示拒绝 |
blocked_by_site_policy | 网站声明了 ai-input=no | 无需操作：网站已表示拒绝 |
target_refused | 网站返回 403、429、验证挑战或登录 | 稍后重试，或向网站申请访问权限 |
fetch_failed | DNS、TLS、连接问题，或 404/410 页面 | 检查 URL；稍后重试 |
fetch_timeout | 网站未及时响应 | 使用更长的 timeout 重试 |
concurrency_limit | 你的账户同时发起了过多请求 | 放慢速度或申请更高的限制 |
invalid_api_key、insufficient_credits | 你的密钥或余额 | 检查控制台 |
错误页面详细说明了每种情况，并附有重试循环。
为什么这里没有实时正常运行时间数据？
因为我们尚未在公开样本上测量过，编造的数字会误导你。读取是否成功主要取决于被读取的网站，因此单一的百分比说明不了什么。一旦我们发布数据，会同时附上方法、样本和日期。
故障在哪里公布？
在更新日志中，包含日期、受影响的端点和所采取的措施。如果你在我方看到重复错误（目标网站原因之外的错误代码），请写信至 [email protected]，并附上请求时间和错误代码。
状态：常见问题
检查我的积分要收费吗？
不收费。GET https://webreaderapi.com/api/v1/credits 从不消耗积分，因此你可以在并发限制内随意将其用于健康检查。
某个页面我这边失败，但在浏览器中能打开。为什么？
通常是因为网站对机器人和真人区别对待：它可能在 robots.txt 中拒绝我们的爬虫，或用验证挑战页面回应自动化请求。我们返回其答复并且不收费。错误代码和 target_status 会显示网站发送了什么。
失败的读取会收费吗？
不会。1 积分 = 读取 1 个页面且无需浏览器；当页面需要浏览器渲染 JavaScript 时为 2 积分。失败的请求，或被网站 robots.txt 拒绝的请求，不扣费。