ضمن باقة المؤسسات

الواجهة البرمجية ومنفذ MCP

اقرأ محفظتك برمجياً: عقارات، وحدات، مستأجرون، عقود وذمم. نفس البيانات التي يراها فريقك في التطبيق، بنفس النطاق تماماً.

للقراءة فقط، عن قصد

المفاتيح تسمح بطلبات GET فقط. أي طلب يكتب يُرفض بـ 403. المفتاح المسرّب يجب ألا يستطيع تعديل سجل إيجار.

١. أنشئ مفتاحاً

من داخل التطبيق: الإعدادات ← المطورون ← مفتاح جديد. المفتاح يظهر مرة واحدة فقط عند إنشائه؛ نحن نخزّن بصمته لا نصه، فإن ضاع أنشئ غيره وألغِ القديم.

نطاق واحد

المفتاح يحل إلى مؤسستك وحدها. لا يمكنه رؤية أي مؤسسة أخرى.

قراءة فقط

GET فقط. الكتابة مرفوضة على مستوى المصادقة.

قابل للإلغاء

الإلغاء فوري، والسجل يحتفظ بما فعله المفتاح.

شكل المفتاح

jbr_live_1a2b3c4d_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

٢. REST

العنوان الأساسي: https://api.jabriya.app · المصادقة عبر ترويسة Authorization.

curl

curl https://api.jabriya.app/buildings \
  -H "Authorization: Bearer jbr_live_…"

الطلب	يعيد
GET/buildings	العقارات مع المنطقة والتصنيف والحالة.
GET/buildings/:id	عقار واحد بالتفصيل، مع أدواره ووحداته.
GET/units?status=VACANT	الوحدات، مع ترشيح بالحالة أو النوع أو البحث.
GET/tenants	المستأجرون، مع ترقيم الصفحات.
GET/contracts?status=ACTIVE	العقود، مع ترقيم وترشيح.
GET/receivables?tenantId=…	الذمم لمستأجر أو عقد أو وحدة.
GET/dashboard/summary	الأرقام الرئيسية خلف لوحة المعلومات.

المبالغ بالدينار الكويتي بثلاث خانات عشرية. التواريخ ISO 8601. القوائم المرقّمة تقبل page وlimit وتعيد { items, total }.

٣. MCP

منفذ MCP يسمح لمساعد ذكي بقراءة محفظتك بلغة طبيعية: "كم وحدة شاغرة عندي؟"، "من تأخر عن السداد؟". يعمل مع أي عميل يدعم MCP عبر HTTP، بنفس المفتاح.

العنوان

POST https://api.jabriya.app/mcp
Authorization: Bearer jbr_live_…

الإعداد في Claude

claude_desktop_config.json

{
  "mcpServers": {
    "jabriya": {
      "type": "http",
      "url": "https://api.jabriya.app/mcp",
      "headers": { "Authorization": "Bearer jbr_live_…" }
    }
  }
}

الأدوات المتاحة

portfolio_summary

العقارات والوحدات والإشغال والمستأجرين والعقود النشطة والذمم القائمة.

list_properties

عقارات المؤسسة.

list_overdue

الذمم المتأخرة وغير المسددة، الأقدم أولاً.

list_expiring_contracts

العقود المنتهية قريباً، لمتابعة التجديد.

list_vacant_units

المتاح للتأجير، مع الإيجار المطلوب.

نداء مباشر

curl -X POST https://api.jabriya.app/mcp \
  -H "Authorization: Bearer jbr_live_…" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
       "params":{"name":"portfolio_summary","arguments":{}}}'

٤. الأخطاء

401	المفتاح غير معروف أو ملغى.
403 API_KEY_READ_ONLY	طلب كتابة بمفتاح. المفاتيح تقرأ فقط.
403 FEATURE_NOT_IN_PLAN	الباقة الحالية لا تشمل الوصول البرمجي.
404	السجل غير موجود، أو ليس ضمن مؤسستك.

لا نفرّق في رسالة الخطأ بين "سجل غير موجود" و"سجل يخص مؤسسة أخرى". كلاهما 404، لأن التفريق بينهما يكشف وجود بيانات ليست لك.

تحتاج مفتاحاً؟

الوصول البرمجي ضمن باقة المؤسسات. تواصل معنا لتفعيله.

[email protected]