# WebReaderAPI 状态：如何检查 API 是否正常工作

> 如何检查 WebReaderAPI 网页阅读器 API 是否正常工作：免费积分端点、各个错误代码的含义，以及在何处发布故障公告。

- URL: https://webreaderapi.com/zh/status/
- 最后更新: 2026-10-22
- 发布者: WebReaderAPI (https://webreaderapi.com)

当页面无法返回时，原因通常是网站本身，有时是网络问题，很少是我们。本页展示如何在几秒钟内分辨原因，且不消耗积分。

**快速回答 — 如何知道 WebReaderAPI 是否正常工作？**

用你的密钥调用 `GET https://webreaderapi.com/api/v1/credits`：这是免费的，正常返回即表示 API 和你的密钥都正常。如果页面读取失败，错误代码会告诉你原因，而且 **WebReaderAPI** 对此不收费。我方的故障会连同日期记录在[更新日志](https://webreaderapi.com/zh/changelog/)中。

## 最快的健康检查是什么？

积分端点。它无需抓取任何网站即可返回，因此只测试我方：身份验证、API 和你的账户。

*curl：检查 API 和剩余积分*

```bash
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` | 你的密钥或余额 | 检查控制台 |

[错误页面](https://webreaderapi.com/zh/docs/errors/)详细说明了每种情况，并附有重试循环。

## 为什么这里没有实时正常运行时间数据？

因为我们尚未在公开样本上测量过，编造的数字会误导你。读取是否成功主要取决于被读取的网站，因此单一的百分比说明不了什么。一旦我们发布数据，会同时附上方法、样本和日期。

## 故障在哪里公布？

在[更新日志](https://webreaderapi.com/zh/changelog/)中，包含日期、受影响的端点和所采取的措施。如果你在我方看到重复错误（目标网站原因之外的错误代码），请写信至 support@webreaderapi.com，并附上请求时间和错误代码。

## 状态：常见问题

### 检查我的积分要收费吗？

不收费。`GET https://webreaderapi.com/api/v1/credits` 从不消耗积分，因此你可以在并发限制内随意将其用于健康检查。

### 某个页面我这边失败，但在浏览器中能打开。为什么？

通常是因为网站对机器人和真人区别对待：它可能在 robots.txt 中拒绝我们的爬虫，或用验证挑战页面回应自动化请求。我们返回其答复并且不收费。错误代码和 `target_status` 会显示网站发送了什么。

### 失败的读取会收费吗？

不会。1 积分 = 读取 1 个页面且无需浏览器；当页面需要浏览器渲染 JavaScript 时为 2 积分。失败的请求，或被网站 robots.txt 拒绝的请求，不扣费。

---

WebReaderAPI: WebReaderAPI 是一款面向 AI agents 的网页读取 API，可将任何公开网页转换为干净的 Markdown，用加密货币支付，无需上传身份证件。预付费积分低至 US$0.07/千页，永不过期，且遵守 robots.txt。无需 KYC — 无身份证、无自拍、无证件。加密货币支付。