Hướng dẫn tích hợp Housing Market API

Các bảng tham chiếu, mô tả endpoint, mã lỗi và ví dụ được tạo từ đặc tả API và được giữ nguyên bằng tiếng Anh ở mọi ngôn ngữ. Tên, tham số và mã đều giống nhau ở mọi nơi.

Giới hạn tốc độ và hạn mức

Mỗi khóa có giới hạn tốc độ theo phút cùng hạn mức theo ngày và theo tháng.

Các giới hạn của khóa được hiển thị trong bảng điều khiển, và mọi phản hồi đều có các header RateLimit-Limit, RateLimit-Remaining và RateLimit-Reset. Hướng dẫn này không công bố con số cụ thể nào.

rate_limited: bạn đã gửi quá nhiều yêu cầu trong phút hiện tại.
quota_exceeded: hạn mức theo ngày hoặc theo tháng của khóa đã được dùng hết.

Cả hai đều trả về HTTP 429 kèm header Retry-After chứa số giây cần chờ. Hãy chờ đúng khoảng thời gian đó, sau đó thử lại với cơ chế lùi theo cấp số nhân (exponential back-off). Đừng thử lại trong một vòng lặp liên tục.

Việc sử dụng được giám sát. Các hình thái sử dụng giống như sao chép tập dữ liệu, hoặc giống như khóa đang bị chia sẻ, có thể dẫn đến việc khóa bị tạm dừng.