جلب بيانات التواصل مع معلن الإعلان
GET/listings/{id}/contact
رقم هاتف المعلن لإعلان نشط واحد. للتواصل مع المعلن بشأن هذا الإعلان فقط، لا لقوائم التسويق ولا لإعادة البيع.
لا يُعاد الرقم إلا إذا حمل الإعلان ترخيصًا من الهيئة العامة للعقار (ترخيص إعلان، ويحمله أيضًا الملّاك الذين يعلنون عن عقاراتهم بأنفسهم، أو ترخيص فال للوساطة)، وكان لدى كايت رقم له، ولم يشمله طلب حجب أو طلب إزالة. وإلا تكون available بالقيمة false ويوضح reason السبب؛ ويبقى source_url موصلًا للإعلان الأصلي. ويخبرك advertiser.contact_available في الإعلان بذلك مسبقًا.
يتطلب النطاق listings:contact، وهو غير مشمول في أي خطة: تفعّله كايت للمؤسسة عند الطلب. لا يمكن استدعاؤه بمفاتيح الاختبار ولا من ساحة التجربة في لوحة التحكم. لكل مؤسسة 200 رقم يوميًا عبر كل مفاتيحها، تتجدد عند منتصف الليل بتوقيت الرياض (UTC+3)، وبعدها يعيد الطلب 429 contact_daily_cap_exceeded مع Retry-After. الإجابات التي لا تحمل رقمًا لا تُحتسب. يُسجَّل كل استعلام مع مؤسستك ومفتاحك والإعلان. الاستجابات بترويسة Cache-Control: private, no-store: لا تخزّن الرقم مؤقتًا ولا تحتفظ به بعد المحادثة التي جلبته لأجلها.
- المصادقة
- أرسل مفتاح بيانات (dk_live_… أو dk_test_…) بصيغة Bearer.
- النطاق
listings:contact- التكلفة
- وحدة واحدة لكل طلب
المعاملات
| الاسم | الوصف |
|---|---|
idمطلوبالنوع: integer · المسار | معرّف الإعلان. |
الاستجابة
الحقل data كائن بهذه الحقول.
| الاسم | الوصف |
|---|---|
availableمطلوبالنوع: boolean | |
reasonمطلوبالنوع: string | null | سبب عدم إعادة رقم؛ null عندما تكون |
phoneمطلوبالنوع: string | null | رقم هاتف المعلن كما نُشر. |
whatsappمطلوبالنوع: string | null | رقم واتساب، إذا قدّمه المصدر منفصلًا عن الهاتف. |
source_urlمطلوبالنوع: string | null | رابط kite.sa يحوّل للإعلان الأصلي، حيث يمكن التواصل مع المعلن عبر المصدر. null في Sandbox أو إذا لم يملك المصدر صفحة إعلان. |
نقاط نهاية ذات صلة
- البحث عن الإعلانات
GET /listings - عدّ الإعلانات
GET /listings/count - جلب الإعلانات بالمعرّف
GET /listings/batch - جلب إعلان
GET /listings/{id} - سجل سعر إعلان
GET /listings/{id}/price-history