موقع عقاراتك، ونظام عملائك، وجدولك: كلها تستطيع أن تسأل السؤال نفسه الذي يجيب عنه مجرة للمشترين. هل هذا السعر مناسب لهذا الحي؟ وتعود الإجابة بيانات تحفظها وترتّبها وتعرضها.
ماذا يفعل
ما تعيده الواجهة، وكيف تصادق طلباتك، وكم تكلّف، وكيف يعمل مساعد ذكي على خط مبيعاتك.
POST /v1/decisions
"verdict": "match"
شقة ١٨٠ م²، النرجس
breakdown.price٧٩breakdown.location٩٠breakdown.size٩٧breakdown.details٦٥benchmark٥٬١٢٠ صفقة بيع مسجّلة، 2023-2025
reasoning: true
reasoning
سعر المتر أقل من متوسط النرجس بنحو ٣٪ وضمن النطاق الأوسط لصفقات الحي. المساحة مناسبة لشقة من ثلاث غرف، والحي من أعلى أحياء الرياض طلباً. التفاصيل أضعف البنود لغياب بيانات الموقف والتشطيب.
key_factorsrisk_flagsنص توضيحي. ٣ قرارات لكل استدعاء مع التحليل.
مفاتيح API
مفاتيح API
استخدم هذه المفاتيح لمصادقة الطلبات على Majarrah Decision API.
الإنتاج
sk-demo••••••••••••••••••••07aa
آخر استخدام: منذ ساعتين
تصادق المفاتيح الطلبات الموجهة إلى https://api.majarrah.io/v1
قرارات API
٥٠٠
قرارات متبقية
POST /v1/decisions reasoning: false-١POST /v1/decisions reasoning: true-٣POST /v1/decisions reasoning: false-١POST /v1/decisions reasoning: false-١١٠٠
قرار
٤٩
٥٠٠
قرار
١٩٩
٢٬٠٠٠
قرار
٦٩٩
خادم MCP
مساعدك الذكي
api.majarrah.io/mcpما الاستفسارات التي لم أرد عليها بعد؟
استفساران مفتوحان: فيصل العتيبي عن فيلا الملقا، وسارة القحطاني عن شقة النرجس.
انقل نورة الراشد إلى مرحلة المعاينة.
تم. نورة الراشد الآن في مرحلة معاينة.
داخل الاستدعاء الواحد
المحرك نفسه الذي يقيّم العقارات للمشترين على مجرة، خلف مفتاح Bearer.
التحقق من المفتاح والحقول
401 / 422مفتاح Bearer صالح، ونوع العقار والسعر والمساحة والموقع مكتملة.
تحديد الحي
districtبالاسم العربي أو الإنجليزي، أو بمعرّفات المدينة والحي من /v1/locations.
مؤشر الحي من وزارة العدل
benchmarkالمتوسط والربيع الأدنى والأعلى لسعر المتر من صفقات البيع المسجّلة.
الدرجة والحُكم
scoreالسعر ٣٠٪، الموقع ٢٠٪، المساحة ٢٠٪، التفاصيل ٣٠٪. من ٧٠ فأعلى match.
تحليل AI (اختياري)
reasoningنص بالعربية والإنجليزية وعوامل القوة والمخاطر. إن تعذّر، تصلك الدرجة كما هي.
خصم القرارات
creditsقرار واحد للتقييم، أو ٣ مع التحليل. والقرارات المتبقية تصلك في الاستجابة.
كيف يعمل
الواجهة موجودة في إعدادات مساحة عملك.
اختر ١٠٠ أو ٥٠٠ أو ٢٬٠٠٠ قرار وادفع بالبطاقة.
سمِّه وانسخه وهو ظاهر.
أرسله إلى /v1/decisions واقرأ الحُكم.
بالتفصيل
GET /v1/locations يطابق المدن والأحياء بالعربية أو الإنجليزية ويعيد معرّفاتها، حتى ٢٠ نتيجة.
أضف districts=true لتحصل على المدينة وكل أحيائها.
401 invalid_api_key، و422 validation_error مع اسم الحقل، و402 insufficient_decisions مع القرارات المتبقية.
تُخصم القرارات في خطوة واحدة في قاعدة البيانات، فلا يستهلك استدعاءان القرار نفسه.
كل استدعاء قرار يحدّث وقت آخر استخدام للمفتاح في إعداداتك.
أسماء الأحياء بأي من اللغتين، والتحليل باللغتين معاً.
كل عضو يرى المفاتيح مخفية، والمالك والمدير يديرانها ويشتريان باقات القرارات.
المفاتيح مخصصة لخادمك، وتنبّه شاشة الإعدادات إلى عدم وضعها في كود المتصفح.
كل كائن يحمل الحقل object: decision أو list أو city أو district.
لماذا يهم
أسئلة شائعة
للوسطاء الذين يبنون أنظمتهم
أنشئ حساب الوسيط، واشحن قرارات API، وأرسل أول عقار إلى /v1/decisions.