Mã lỗi — API dữ liệu WhatsApp
Tất cả các phản hồi lỗi đều tuân theo cùng một định dạng: trạng thái HTTP + thông báo lỗi + mã số + dấu thời gian.
Hình dạng phong bì (quan sát được)
Proxy trả về một trong hai hình dạng tùy thuộc vào chế độ lỗi:
Lỗi ngắn (xác thực / giới hạn số lần gọi / xác thực):
{ "error": "Requests must be at least 0.5 seconds apart" }Lỗi chi tiết (tìm kiếm không thành công trên /number/no_picture/{n}, /number-simple/{n}) — phần thân vẫn được phân tích cú pháp như một WhatsAppEntry với các trường bổ sung:
{
"number": "13105551234",
"isWAContact": true,
"error": "Whatsapp number doesn't exist",
"exists": false,
"reason": "not_found",
"status": 404,
...
}Luôn kiểm tra trường lỗi ngay cả khi nhận được phản hồi 200 (ví dụ: /number_cache có thể trả về 200 kèm theo thông báo lỗi).
Các trạng thái HTTP phổ biến
| HTTP | Nghĩa | Hoạt động |
|---|---|---|
| 400 | Số điện thoại không hợp lệ — phải khớp với ^[0-9]+$ (chỉ các chữ số, không có dấu +). | Loại bỏ các ký tự không phải chữ số trước khi gửi. Xác thực bằng thư viện libphonenumber cục bộ. |
| 401 | Thiếu hoặc tiêu đề x-rapidapi-key không hợp lệ. | Thêm các tiêu đề x-rapidapi-key và x-rapidapi-host: wp-data.p.rapidapi.com. |
| 403 | Cần có gói cước đang hoạt động, đã hết dung lượng hoặc thiết bị đầu cuối không thuộc gói cước của bạn. | Kiểm tra gói đăng ký RapidAPI. Nâng cấp gói hoặc nạp tiền. |
| 404 | Không tìm thấy điểm cuối hoặc tài nguyên. | Hãy kiểm tra đường dẫn URL. Đối với /number/{number}, một số điện thoại không xác định vẫn trả về WhatsAppEntry với isWAContact: false — hãy kiểm tra nội dung tin nhắn, chứ không phải trạng thái. |
| 429 | Giới hạn bùng nổ — các yêu cầu quá gần nhau. Nội dung: {"error":"Requests must be at least 0.5 seconds apart"}. | Ngủ ít nhất 500 ms giữa các yêu cầu (2 yêu cầu/giây). MEGA: 250 ms (4 yêu cầu/giây). Đọc /api-key-stats → roleInfo.minIntervalSeconds để xác nhận tốc độ của gói cước. |
| 500 | Lỗi máy chủ không mong muốn. | Thử lại với phương pháp lùi thời gian theo cấp số nhân. Báo cáo nếu tình trạng vẫn tiếp diễn. |
| 502 / 503 | Thư mục WhatsApp phía trên không khả dụng hoặc tốc độ dịch vụ bị giới hạn từ phía máy chủ. | Thử lại với chế độ lùi thời gian. Kiểm tra /api-status. |
| 504 | Tra cứu nguồn dữ liệu phía trên đã hết thời gian chờ. | Thử lại một lần nữa. Hãy thử /number/no_picture/{number} để nhận phản hồi nhanh hơn. |
Chiến lược thử lại
- Thử lại: 429 (với Retry-After), 500, 502, 503, 504.
- Không thử lại: 400, 401, 403, 404.
- Giảm độ trễ: theo cấp số nhân có độ nhiễu. Giới hạn ở 5 lần thử lại. Luôn luôn tuân thủ Retry-After.
Ví dụ 429 phần thân
HTTP/1.1 429 Too Many Requests
content-type: application/json
{ "error": "Requests must be at least 0.5 seconds apart" }Có liên quan
Người Dùng Nói Gì
Đánh giá thực từ khách hàng hài lòng của chúng tôi
Đang tải đánh giá...