# Tình trạng WebReaderAPI: cách kiểm tra API có đang hoạt động không

> Cách kiểm tra API đọc trang web của WebReaderAPI có hoạt động không: endpoint credit miễn phí, ý nghĩa của từng mã lỗi, và nơi thông báo sự cố.

- URL: https://webreaderapi.com/vi/status/
- Cập nhật lần cuối: 2026-10-22
- Đơn vị phát hành: WebReaderAPI (https://webreaderapi.com)

Khi một trang không trả về kết quả, nguyên nhân thường là trang web, đôi khi là mạng, và hiếm khi là chúng tôi. Trang này chỉ cách phân biệt trong vài giây mà không tốn credit.

**Câu trả lời nhanh — Làm sao biết WebReaderAPI có đang hoạt động không?**

Gọi `GET https://webreaderapi.com/api/v1/credits` với khóa của bạn: miễn phí, và một phản hồi bình thường nghĩa là API và khóa của bạn hoạt động. Nếu một trang thất bại, mã lỗi cho bạn biết lý do, và **WebReaderAPI** không tính phí cho việc đó. Các sự cố từ phía chúng tôi được ghi lại trên [changelog](https://webreaderapi.com/vi/changelog/) kèm ngày tháng.

## Cách kiểm tra tình trạng nhanh nhất là gì?

Endpoint credit. Nó phản hồi mà không cần tải bất kỳ trang web nào, nên chỉ kiểm tra phía chúng tôi: xác thực, API và tài khoản của bạn.

*curl: kiểm tra API và số credit còn lại của bạn*

```bash
curl -s https://webreaderapi.com/api/v1/credits -H "Authorization: Bearer $WEBREADER_API_KEY"

```

## Những lỗi nào đến từ trang web, và những lỗi nào từ chúng tôi?

Mã lỗi cho biết vấn đề nằm ở đâu. Không lỗi nào trong số này dùng credit.

| Mã | Vấn đề nằm ở đâu | Cần làm gì |
|---|---|---|
| `blocked_by_robots` | robots.txt của trang từ chối trình thu thập của chúng tôi | Không cần làm gì: trang web đã từ chối |
| `blocked_by_site_policy` | Trang web khai báo `ai-input=no` | Không cần làm gì: trang web đã từ chối |
| `target_refused` | Trang web trả về 403, 429, một thử thách hoặc yêu cầu đăng nhập | Thử lại sau, hoặc xin quyền truy cập từ trang web |
| `fetch_failed` | DNS, TLS, kết nối, hoặc trang 404/410 | Kiểm tra URL; thử lại sau |
| `fetch_timeout` | Trang web không phản hồi kịp | Thử lại với `timeout` dài hơn |
| `concurrency_limit` | Quá nhiều truy vấn cùng lúc từ tài khoản của bạn | Giảm tốc độ hoặc yêu cầu giới hạn cao hơn |
| `invalid_api_key`, `insufficient_credits` | Khóa API hoặc số dư của bạn | Kiểm tra bảng điều khiển |

[Trang lỗi](https://webreaderapi.com/vi/docs/errors/) mô tả chi tiết từng trường hợp, kèm vòng lặp thử lại.

## Tại sao ở đây không có số liệu uptime trực tiếp?

Vì chúng tôi chưa đo được số liệu nào trên một mẫu công khai, và một con số bịa ra sẽ đánh lừa bạn. Thành công của một lần đọc chủ yếu phụ thuộc vào trang web được đọc, nên một tỷ lệ phần trăm duy nhất sẽ không nói lên được nhiều. Khi chúng tôi công bố số liệu, chúng sẽ đi kèm phương pháp, mẫu và ngày tháng.

## Sự cố được thông báo ở đâu?

Trên [changelog](https://webreaderapi.com/vi/changelog/), kèm ngày tháng, các endpoint bị ảnh hưởng và những gì đã được xử lý. Nếu bạn thấy lỗi lặp lại từ phía chúng tôi (các mã khác với những mã do trang đích gây ra), hãy viết đến support@webreaderapi.com kèm thời gian truy vấn và mã lỗi.

## Tình trạng: các câu hỏi thường gặp

### Kiểm tra credit có tốn phí không?

Không. `GET https://webreaderapi.com/api/v1/credits` không bao giờ dùng credit, nên bạn có thể gọi nó từ một bước kiểm tra tình trạng bao nhiêu lần tùy thích, trong giới hạn đồng thời của bạn.

### Một trang thất bại với tôi nhưng vẫn mở được trên trình duyệt của tôi. Tại sao?

Thường là vì trang web đối xử với robots khác với người dùng: nó có thể từ chối trình thu thập của chúng tôi trong robots.txt hoặc trả về một trang thử thách cho các truy vấn tự động. Chúng tôi trả về câu trả lời của trang web và không tính phí. Mã lỗi và `target_status` cho thấy trang web đã gửi gì.

### Các lần đọc thất bại có bao giờ bị tính phí không?

Không. 1 credit = đọc 1 trang không cần trình duyệt; 2 credit khi trang cần trình duyệt để render JavaScript. Yêu cầu thất bại, hoặc bị robots.txt của trang web từ chối, không bị tính phí.

---

WebReaderAPI: WebReaderAPI là web reader API cho AI agent, chuyển mọi trang web công khai thành Markdown sạch, thanh toán bằng crypto không cần tải lên giấy tờ. Credit trả trước từ 0,07 US$/1K trang không bao giờ hết hạn, và robots.txt được tôn trọng. Không cần KYC — không ID, không selfie, không giấy tờ. Thanh toán bằng crypto.