انتقل إلى المحتوى الرئيسي

دروس دورة Housing Market API التعليمية

بيانات العقارات للمطوّرين: المفاتيح، والدول، والخطط، والتوثيق.

لـالمطوّرون وفرق البيانات. عدد الدروس: 17، وعدد الأقسام: 4.

تقدمك: تمت مشاهدة 0 من 17

1. ابدأ من هنا

  1. توثيق Housing Market API ودليل PDF والفواتيرقيد التحديث حاليًاكل ما تحتاجه لدمج Housing Market API موجود في لوحة الإدارة: التوثيق المبني على المواصفة نفسها التي تعمل بها واجهة API، وملف OpenAPI لاستخدامه في أدواتك الخاصة، ودليل دمج يمكن تنزيله بصيغة PDF. وبطاقتك وفواتيرك على بعد نقرة واحدة. يستعرض هذا الدرس التوثيق، ويعثر على ملف OpenAPI وعلى الدليل، ويبيّن مكان الفواتير والدفع.
  2. تعرّف على البلدان التي يغطيها Housing Market APIقيد التحديث حاليًاتُظهر صفحة التغطية في Housing Market API كل بلد يمكن أن يغطيه الـ API، مُصنَّفًا حسب المنطقة: آسيا والمحيط الهادئ، والشرق الأوسط، وأوروبا، والأمريكتان. كل بلد يأتي من بوابة تابعة لـ Housing Market Group، ويمكنك شراء البلدان بلدًا بلدًا، أو منطقة كاملة، أو تغطية عالمية. أي بلد يحمل علامة «قيد التحديث حاليًا» لم يُطرح للبيع بعد. ويرتبط اسم كل بلد ببوابته في علامة تبويب جديدة، لتتمكّن من رؤية العقارات التي تقف خلف البيانات. يفتح هذا الدرس صفحة التغطية ويشرحها خطوة بخطوة. ولا تحتاج إلى حساب.

2. حسابك

  1. كيفية تسجيل الدخول إلى لوحة إدارة Housing Market APIقيد التحديث حاليًالوحة إدارة Housing Market API هي المكان الذي تختار فيه بلدانك وخطتك، وتسجّل عنوان خادمك، وتدفع، وتجد فيه مفتاح API الخاص بك. تسجّل الدخول بحساب Housing Market الخاص بك، بالبريد الإلكتروني وكلمة المرور نفسهما التي تستخدمها في البوابات أو في Housing Market CRM أو في أي منتج آخر من منتجات Housing Market. يفتح هذا الدرس صفحة تسجيل الدخول إلى لوحة الإدارة، ويوضّح ما يجب إدخاله، ويشير إلى رابط إنشاء حساب ورابط كلمة المرور المنسية، وإلى قائمة اللغات في الشريط العلوي.
  2. كيفية إنشاء حساب Housing Market APIقيد التحديث حاليًايمنح Housing Market API برنامجك إمكانية الوصول إلى العقارات المنشورة في بوابات Housing Market، بلدًا بلدًا. وتبدأ العملية بإنشاء حساب في لوحة إدارة API. يفتح هذا الدرس صفحة التسجيل، ويُدخل عنوان بريد إلكتروني وكلمة مرور، ويشرح رمز التأكيد المُرسل بالبريد الإلكتروني، ويوضّح الخطوات التالية.
  3. تأكيد بريدك الإلكتروني عبر رابط في لوحة إدارة Housing Market APIقيد التحديث حاليًايمكنك تسجيل الدخول إلى لوحة إدارة Housing Market API بمجرد أن يكون لديك حساب، لكن لا يمكنك استخدامها إلا بعد تأكيد عنوان بريدك الإلكتروني. في هذا الدرس نسجّل الدخول بعنوان لم يُؤكَّد بعد، ونستعرض صفحة «تحقّق من بريدك الإلكتروني»، ونطلب رسالة تأكيد جديدة، ونوضّح كيفية تصحيح عنوان كُتب بالخطأ، ثم نفتح الرابط المُرسَل في الرسالة ونضغط الزر الموجود فيه. لا يوجد أي رمز لإدخاله في أي مكان.
  4. كيفية إنشاء حساب Housing Market API عبر رابط البريد الإلكترونيقيد التحديث حاليًايمنح Housing Market API برنامجك إمكانية الوصول إلى العقارات المنشورة في بوابات Housing Market، بلدًا بلدًا. ويبدأ الأمر بإنشاء حساب في لوحة إدارة API. يفتح هذا الدرس صفحة التسجيل، ويُدخل عنوان بريد إلكتروني وكلمة مرور، ويشرح رابط التأكيد المُرسل بالبريد الإلكتروني (لا يوجد رمز يجب كتابته)، ويوضّح الخطوات التالية.

3. الخطط والدول والدفع

  1. كيفية اختيار الدول والخطة في Housing Market APIقيد التحديث حاليًايُباع Housing Market API حسب نطاق التغطية: دول فردية، أو منطقة كاملة، أو العالم بأكمله، مع فوترة شهرية أو سنوية. وهناك خطتان: Standard التي تتضمّن عروض العقارات بكل تفاصيلها، وAdvanced التي تضيف بيانات Insights المجمّعة للسوق عند إطلاقها، وكلتاهما بالسعر نفسه. يوضّح هذا الدرس اختيار الدول، ومقارنة خيار المنطقة بخيار العالم بأكمله، واختيار الخطة ومدة الفوترة، ثم المتابعة.
  2. كيفية إضافة دولة أو ترقية خطة Housing Market APIقيد التحديث حاليًاخطة Housing Market API تنمو معك: أضف دولة، أو انتقل إلى منطقة أو إلى النطاق العالمي، أو انتقل إلى Advanced، ويغطي المفتاح نفسه ذلك بمجرد تأكيد الدفع. يفتح هذا الدرس شاشة تغيير الخطة، ويضيف دولة، ويوضّح كيف تُحتسب تكلفة الإضافة والإزالة.
  3. أسعار Housing Market API: اختر دولاً أو منطقة أو العالم بأكملهقيد التحديث حاليًايُباع Housing Market API حسب نطاق التغطية: دول فردية، أو منطقة كاملة، أو العالم بأكمله، بفاتورة شهرية أو سنوية. وهناك خطتان: Standard التي تشمل عقارات المعروضة وجميع تفاصيلها، وAdvanced التي تضيف بيانات Insights المجمّعة للسوق بمجرد إطلاقها، وكلتاهما بالسعر نفسه. في هذا الدرس نختار الدول، ونقارن بين خيار المنطقة وخيار العالم بأكمله، ونحدد الخطة وفترة الفوترة، ثم نتابع.
  4. أضف دولة أو ارفع خطة Housing Market API الخاصة بك (المفتاح نفسه)قيد التحديث حاليًاخطة Housing Market API تنمو معك: أضف دولة، أو انتقل إلى منطقة أو إلى النطاق العالمي، أو انتقل إلى Advanced، ويغطي المفتاح نفسه ذلك بمجرد تأكيد الدفع. يفتح هذا الدرس شاشة تغيير الخطة، ويضيف دولة، ويوضّح كيف تُحتسب تكلفة الإضافة والإزالة.
  5. Housing Market API: لم تتم عملية الدفع؟ أعد المحاولةقيد التحديث حاليًاإذا لم تتم عملية الدفع الأولى لخطتك في Housing Market API، تُظهر لوحة الإدارة ذلك على لوحة التحكم الخاصة بك وتعرض زر «إعادة الدفع». لم يتم إنشاء أي مفتاح API ولم يُحتفظ بأي شيء، لذا يمكنك إعادة المحاولة بالبطاقة نفسها أو ببطاقة أخرى، ويتم إنشاء مفتاحك بمجرد نجاح الدفع. يوضّح هذا الدرس الرسالة وإلى أين يأخذك زر «إعادة الدفع».
  6. Housing Market API: إضافة بلدان إلى خطتك أو إزالتهاقيد التحديث حاليًافي خطة البلدان من Housing Market API يمكنك إضافة بلدان أو إزالتها من صفحة «بلدانك». وقبل تحصيل أي مبلغ، تُظهر خطوة تأكيد ما الذي سيتغيّر، والمبلغ المحصَّل الآن في حالة الإضافة، والسعر بعد التغيير، وموعد سريانه. في هذا الدرس نضيف بلدًا، ثم نستعرض إزالة بلد.

4. المفاتيح والطلب الأول

  1. كيفية تسجيل عنوان IP لخادمك في Housing Market APIقيد التحديث حاليًالا يعمل مفتاح Housing Market API إلا من عنوان الخادم الواحد الذي تسجّله، وقبل الدفع توافق على شروط الـ API. في هذا الدرس نُدخل عنوان IP الخاص بالخادم، ونوضّح لماذا لا يكون العنوان الذي يظهره متصفّحك هو العنوان الصحيح في العادة، ونقرأ خطوة الشروط ونصل حتى صفحة الدفع الآمن.
  2. كيفية الحصول على مفتاح Housing Market API — يُعرض مرة واحدة فقطقيد التحديث حاليًابعد تأكيد أول عملية دفع، يصبح مفتاح Housing Market API الخاص بك جاهزًا، ويُعرض مرة واحدة فقط بالضبط. يفتح هذا الدرس المفتاح وينسخه، ويشرح أين تحفظه وكيف ترسله مع كل طلب.
  3. طلبك الأول إلى Housing Market APIقيد التحديث حاليًابعد الحصول على المفتاح، يكفي طلب HTTPS واحد لإرجاع قوائم العقارات في البلد الذي دفعت مقابله. يفتح هذا الدرس أمثلة الطلبات في التوثيق، ويتحقّق من المفتاح باستخدام ping، ويطلب العقارات في تايلاند، ويقرأ الاستجابة ومؤشّر الصفحات فيها، ثم يجلب الصفحة التالية.
  4. لوحة تحكم Housing Market API — الاستخدام وتدوير المفتاح وعنوان IPقيد التحديث حاليًاتعرض لوحة تحكم Housing Market API نطاق التغطية الخاص بك، ومقدار ما استهلكته من حصتك اليوم وهذا الشهر، ومفتاحك، وعنوان الخادم الذي يعمل منه. يشرح هذا الدرس كيفية قراءة التغطية وجدول الاستخدام، ويوضّح تدوير المفتاح مع فترة التداخل البالغة 24 ساعة، وكيفية تغيير عنوان الخادم المسجّل.
  5. Housing Market API: الإعلانات في لوحة الإدارةقيد التحديث حاليًاعندما يكون لدى Housing Market Group ما يريد إبلاغك به، مثل تنبيه أو فترة صيانة مُجدوَلة، يظهر ذلك كشريط أسفل ترويسة لوحة إدارة Housing Market API الخاصة بك. يوضّح هذا الدرس شكل الإعلان، وكيفية فتح رابط «معرفة المزيد» الخاص به، وكيفية إخفائه ليبقى بعيدًا عن طريقك في ذلك المتصفح. الإعلانات الواردة في هذا الفيديو هي أمثلة توضيحية.