Hubz API v1 (beta) · Hubz v0.7.0 · 2026-11-06
Giới hạn tốc độ và mã lỗi
Giới hạn tốc độ
Khoảng 300 request mỗi phút cho mỗi khóa. Mức này có thể điều chỉnh trong giai đoạn beta. Vượt giới hạn, API trả 429 kèm header Retry-After (số giây cần chờ).
Tin gửi qua API đi qua cùng hàng đợi và giới hạn chống spam của số Zalo như khi nhân viên gửi tay, nên tin có thể chờ vài giây trước khi tới khách. Tin được trả về với status là queued, sau đó sent hoặc failed (sự kiện message.updated).
Mã lỗi
| Mã | Ý nghĩa |
|---|---|
400 | Dữ liệu gửi lên không hợp lệ; details cho biết chỗ sai. |
401 | Khóa sai hoặc đã bị thu hồi. |
403 | Khóa hoặc nhân viên (X-Hubz-User) thiếu quyền. |
404 | Không tìm thấy, hoặc không được xem bản ghi này. |
429 | Vượt giới hạn tốc độ: chờ theo Retry-After rồi gửi lại. |
Lỗi 400:
{"error": "Dữ liệu không hợp lệ", "details": ["…"]}
Các lỗi khác:
{"error": "…"}
Hubz không phải sản phẩm của Zalo hay VNG; Hubz không dùng API chính thức của Zalo. Hubz không liên kết với Odoo S.A.; Odoo là nhãn hiệu của Odoo S.A.