Bỏ qua để đến Nội dung
Beta: Hubz API v1 đang được triển khai lên production. Endpoint và giới hạn có thể thay đổi; mọi thay đổi được ghi ở Nhật ký thay đổi.

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
400Dữ liệu gửi lên không hợp lệ; details cho biết chỗ sai.
401Khóa sai hoặc đã bị thu hồi.
403Khóa hoặc nhân viên (X-Hubz-User) thiếu quyền.
404Không tìm thấy, hoặc không được xem bản ghi này.
429Vượ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.