دليل التكامل مع Housing Market API

تُولَّد الجداول المرجعية وأوصاف نقاط النهاية ورموز الأخطاء والأمثلة من مواصفات API، وتبقى باللغة الإنجليزية في كل اللغات. الأسماء والمعاملات والرموز متطابقة في كل مكان.

حدود المعدل والحصص

لكل مفتاح حد معدل في الدقيقة، وحصص يومية وشهرية.

تُعرض حدود مفتاحكم في وحدة التحكم، وتحمل كل استجابة الترويسات RateLimit-Limit وRateLimit-Remaining وRateLimit-Reset. لا تُنشر أي أرقام في هذا الدليل.

rate_limited: أرسلتم طلبات كثيرة جدًا في الدقيقة الحالية.
quota_exceeded: استُنفدت الحصة اليومية أو الشهرية للمفتاح.

يُعاد كلاهما بالحالة HTTP 429 مع ترويسة Retry-After تحمل عدد الثواني الواجب انتظارها. انتظروا هذه المدة، ثم أعيدوا المحاولة مع تراجع أسّي (exponential back-off). لا تعيدوا المحاولة في حلقة متلاحقة.

يخضع الاستخدام للمراقبة. قد تؤدي الأنماط التي تبدو كنسخ لمجموعة البيانات، أو كمشاركة لمفتاح، إلى إيقاف المفتاح مؤقتًا.