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 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 -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 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, 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 [email protected] 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í.