دليل التكامل مع Housing Market API
تُولَّد الجداول المرجعية وأوصاف نقاط النهاية ورموز الأخطاء والأمثلة من مواصفات API، وتبقى باللغة الإنجليزية في كل اللغات. الأسماء والمعاملات والرموز متطابقة في كل مكان.
نظرة عامة والخطط
تمنح Housing Market API برنامجكم وصولًا للقراءة فقط إلى إعلانات العقارات المنشورة على بوابات Housing Market Group. وستتوفر إحصاءات السوق المجمّعة قريبًا في الخطة المتقدمة.
يُرسَل كل طلب إلى https://api.housingmarketapi.com عبر HTTPS، وتكون كل استجابة بصيغة JSON. جميع نقاط النهاية للقراءة فقط: فهي كلها طلبات GET.
تتوفر خطتان. تستخدم كلتاهما المفتاح نفسه ونقاط النهاية نفسها للإعلانات.
- القياسية: الإعلانات المنشورة مع جميع تفاصيل العقار الموضحة في هذا الدليل، للدول التي تشتركون فيها.
- المتقدمة: كل ما في الخطة القياسية، بالإضافة إلى نقاط نهاية Insights (حجم عمليات البحث، وحجم العملاء المحتملين، والأسعار، وأعداد العقارات، ومستويات النشاط، وبيانات السوق من جهات خارجية)، وتتوفر قريبًا. ويحصل عملاء الخطة المتقدمة على Insights على المفتاح نفسه فور إطلاقها.
بيانات Insights مجمّعة. كل قيمة هي عدد أو وسيط لمكان وفترة زمنية؛ ولا شيء منها يصف فردًا أو عميلًا محتملًا أو وكيلًا أو إعلانًا بعينه.
تختارون الدول عند الاشتراك: دولًا منفردة، أو منطقة، أو تغطية عالمية. يمكنكم إضافة دول أو الترقية لاحقًا، وعندها يغطيها المفتاح نفسه.
يمكنكم الدفع شهريًا أو سنويًا. تعرض وحدة التحكم بالضبط المبلغ الذي سيُحصَّل منكم قبل أن تؤكدوا، لذلك لا تُذكر أي أسعار في هذا الدليل.
تُكتب الدول دائمًا برموز الدول وفق معيار ISO، على سبيل المثال TH لتايلاند. تعرض وحدة التحكم الدول التي يغطيها مفتاحكم.