فهرس الواجهات الداخليةInternal API catalog
كل واجهات API الداخلية المذكورة في صفحات الميزات مع اصطلاحاتها المشتركة.
الواجهات
كل الواجهات أدناه داخلية في ERPOS، بالاسم البرمجي المفترض legal_erp افتراض تنفيذي (التعارض C-02). القراءة البسيطة عبر REST الجاهز /api/resource/<DocType> الذي يحترم الصلاحيات؛ والشاشات عبر دوال /api/method/legal_erp.api.v1.<area>.<fn> والإصدار في المسار (دليل المطور ص19).
لا واجهات حكومية هنا
لا يحتوي هذا الفهرس أي endpoint لجهة حكومية. مسارات ناجز وغيرها لا تُعرف إلا من الملف التقني بعد الموافقة ناجز وناجز للمطورين.
اصطلاحات مشتركة
| البند | القاعدة |
|---|---|
| المصادقة | جلسة Frappe (ويب) أو رمز API لكل مستخدم (جوال)؛ لا مفاتيح في المتصفح. |
| الصلاحية | كل دالة تتحقق بـ frappe.has_permission وتجلب بـ frappe.get_list. |
| الأخطاء | 403 صلاحية، 404 غير موجود أو غير مرئي (لا يُميَّز بينهما للحماية)، 409 تعارض نسخة، 417 تحقق، 429 حد الاستخدام. |
| عدم التكرار | العمليات من الجوال تحمل client_request_id المزامنة دون اتصال. |
| الترقيم | limit_start وlimit_page_length. |
| التاريخ | ISO 8601 بتوقيت +03:00؛ التاريخ الهجري للعرض فقط. |
الواجهات (27)
| الطريقة | المسار | الوصف | الصلاحية | الميزة |
|---|---|---|---|---|
POST | /api/method/legal_erp.api.v1.access.request_exceptional_access | طلب دخول استثنائي لملف محجوب أو لست في فريقه (للشريك أو بإذن مسبق). | مستخدم مفعّل؛ يُرفض لمن في قائمة الحاجز. | B01 |
POST | /api/method/legal_erp.api.v1.parties.find_or_create | يبحث بالبصمة أولًا ثم بالاسم الموحد، ويعيد المطابقات قبل الإنشاء. | شريك، محامٍ، سكرتارية. | B02 |
GET | /api/resource/Legal Matter?fields=["name","title","stage","status"] | قائمة ملفات المستخدم (REST الجاهز في Frappe، يحترم الصلاحيات) (دليل المطور ص19). | بحسب قاعدة الفريق. | B03 |
POST | /api/method/legal_erp.api.v1.matters.close | إغلاق الملف بتاريخ ونتيجة. | المحامي المسؤول أو الشريك. | B03 |
POST | /api/method/legal_erp.api.v1.court.start_next_stage | إنشاء مرحلة طعن أو تنفيذ من حكم. | فريق الملف. | B04 |
POST | /api/method/legal_erp.api.v1.matters.remove_wall | رفع حاجز. | الشريك فقط. | B06 |
GET | /api/method/legal_erp.api.v1.poa.for_matter?matter=MAT-2026-00001 | الوكالات السارية لملف مع صلاحياتها. | فريق الملف. | B07 |
POST | /api/method/legal_erp.api.v1.poa.check | فحص إجراء. | فريق الملف. | B08 |
GET | /api/method/legal_erp.api.v1.mobile.today | جلسات اليوم ومهله للمحامي (واجهة الجوال) (دليل المطور ص20). | المستخدم نفسه. | B09 |
POST | /api/method/legal_erp.api.v1.mobile.submit_hearing_report | حفظ مسودة من الجوال (يعمل دون اتصال عبر الطابور B34 العمل دون اتصال). | المحامي الحاضر. | B10 |
POST | /api/method/legal_erp.api.v1.deadlines.preview | حاسبة: معاينة دون حفظ. | محامٍ أو شريك. | B12 |
POST | /api/method/legal_erp.api.v1.documents.upload | رفع مستند (multipart). | فريق الملف أو الموكّل لملفاته. | B13 |
POST | /api/method/legal_erp.api.v1.templates.render | تعبئة قالب لملف. | فريق الملف. | B14 |
GET | /api/method/legal_erp.api.v1.library.article_in_force?law=LAW-CPL&number=187&on=2026-11-04 | نص المادة النافذ في تاريخ. | كل المستخدمين الداخليين. | B15 |
POST | /api/method/legal_erp.api.v1.conflicts.run | تشغيل فحص. | سكرتارية، محامٍ، شريك. | B16 |
POST | /api/method/legal_erp.api.v1.intake.check_in | مسح QR من جهاز الاستقبال. | رمز جهاز الاستقبال فقط. | B17 |
GET | /api/method/legal_erp.api.v1.tasks.suggest?task=TASK-0091 | مرشحو الإسناد. | الشريك أو من يملك الإسناد. | B18 |
POST | /api/method/legal_erp.api.v1.mobile.hearing_event | ضغط زر جلسة. | المحامي الحاضر. | B19 |
POST | /api/method/legal_erp.api.v1.pricing.estimate | تقدير. | محامٍ أو شريك. | B20 |
POST | /api/method/legal_erp.api.v1.portal.sign_contract | توقيع الموكّل بعد OTP. | الموكّل الطرف في العقد. | B22 |
POST | /api/method/legal_erp.api.v1.notices.ingest_sms | استقبال رسالة ممررة. | رمز سري لكل مكتب يُدار في الخزنة، يُرسل في ترويسة. | B28 |
POST | /api/method/legal_erp.api.v1.ai.ask | سؤال من واجهة المحامي. | محامٍ أو شريك؛ حد الاستخدام. | B29 |
POST | /api/method/legal_erp.integrations.whatsapp.webhook | استقبال أحداث واتساب. | التحقق من توقيع المنصة؛ تجاهل المعرّف المكرر. | B30 |
GET | /api/method/legal_erp.api.v1.mobile.today | شاشة اليوم (انظر B09 الجلسات والتقويم المزدوج ومنع التعارض الزمني). | المستخدم نفسه. | B33 |
POST | /api/method/legal_erp.api.v1.mobile.sync | إرسال الطابور. | المستخدم نفسه. | B34 |
GET | /api/method/legal_erp.api.v1.portal.my_matters | ملفات الموكّل. | الموكّل. | B35 |
POST | /api/method/legal_erp.api.v1.najiz.link_matter | طلب ربط (يُدرج في طابور). | فريق الملف. | B45 |