منصة حكيم

واجهات منصة حكيم — API

واجهات المعرفة القضائية في منصة حكيم: البحث الموحّد، الاقتراحات، مكتبة تراث، المبادئ القضائية، والمعرّف التشريعي (ELI). تتطلّب معظم الواجهات جلسة مصادقة وصلاحية مناسبة.

توثيق لمجموعة أساسية مختارة من الواجهات؛ ليست كل واجهات المنصّة.

البوابة الخارجية

get/api/legal/search

بحث قانوني (بوابة خارجية)

بحث هجين في النواة القانونية. متاح بمفتاح API خارجي (Bearer/x-api-key، نطاق legal:read) أو جلسة داخلية.

المعاملات

  • q (query، إلزامي)
  • limit (query)
200 نتائج البحث400 عبارة قصيرة401 مفتاح مفقود/غير صالح403 المفتاح لا يملك النطاق429 تجاوز حدّ المعدّل
get/api/legal/systems

قائمة الأنظمة (بوابة خارجية)

المعاملات

  • q (query)
  • classification (query)
  • page (query)
  • pageSize (query)
200 أنظمة مع ترقيم401 غير مصادق429 تجاوز الحدّ
get/api/legal/systems/{id}

تفاصيل نظام (بوابة خارجية)

المعاملات

  • id (path، إلزامي) — معرّف النظام أو اسمه
200 النظام ومواده بالفصول404 غير موجود
get/api/legal/articles

سحب جماعي + تغذية تغييرات للمواد (مزامنة خارجية)

للمزامنة التزايدية: مرّر قيمة syncCursor العائدة كـ updatedSince في الطلب التالي.

المعاملات

  • updatedSince (query) — أعِد فقط ما تغيّر بعد هذا الوقت (ISO 8601)
  • systemId (query)
  • page (query)
  • pageSize (query)
200 مواد + total + hasMore + syncCursor401 غير مصادق429 تجاوز الحدّ
get/api/legal/articles/{id}

مادة مع الاستناد والمعرّف التشريعي (بوابة خارجية)

المعاملات

  • id (path، إلزامي)
200 المادة + citation + eli404 غير موجودة
get/api/legal/articles/{id}/related

مواد ذات صلة وإحالات داخلية (بوابة خارجية)

المعاملات

  • id (path، إلزامي)
200 related + crossReferences404 غير موجودة
get/api/legal/articles/{id}/fiqh

المواءمة الفقهية المساندة (غير ملزمة) (بوابة خارجية)

المعاملات

  • id (path، إلزامي)
200 fiqh مع تنبيه عدم الإلزام404 غير موجودة

البحث

get/api/legal-search

بحث هجين موحّد

بحث نصّي + دلالي + رسم معرفي عبر المواد والأحكام والمبادئ.

المعاملات

  • q (query، إلزامي) — عبارة البحث
  • limit (query)
200 نتائج مجمّعة حسب النوع400 عبارة بحث قصيرة401 غير مصادق403 لا صلاحية
get/api/legal-search/suggest

اقتراحات إكمال تلقائي

المعاملات

  • q (query، إلزامي)
200 قائمة اقتراحات

تراث

get/api/turath/search

بحث في مكتبة تراث

بحث حيّ في المصادر الفقهية مفتوحة المصدر مع الإسناد والترقيم.

المعاملات

  • q (query، إلزامي)
  • limit (query)
  • page (query)
200 نتائج تراث مع البيانات الوصفية والإجمالي401 غير مصادق

النواة القانونية

patch/api/legal-core/principles/{id}

مراجعة مبدأ قضائي

اعتماد/رفض/إعادة مبدأ مستخرَج. تتطلّب صلاحية LEGAL_CORE_EDIT.

المعاملات

  • id (path، إلزامي)
200 تم التحديث403 لا صلاحية تعديل404 المبدأ غير موجود
get/eli/sa/{system}/art/{number}

محلّل المعرّف التشريعي (ELI)

معرّف ثابت بنمط ELI يحوّل إلى صفحة المادة المطابقة.

المعاملات

  • system (path، إلزامي) — slug اسم النظام (مطبّع)
  • number (path، إلزامي) — رقم المادة
307 تحويل إلى صفحة المادة404 لا مادة مطابقة

المصادقة

post/api/auth/login

تسجيل الدخول

200 جلسة مفعّلة (كوكي)401 بيانات غير صحيحة
post/api/auth/logout

تسجيل الخروج

200 أُنهيت الجلسة