حكيم · واجهة المطوّرين
API المعرفة القانونية السعودية
تكامل موقعك أو نظام الذكاء الاصطناعي لديك مع النواة القانونية لمنصّة حكيم: بحث في الأنظمة والمواد والمبادئ، مع استناد رسمي إلى المصدر — بلا اختلاق ولا هلوسة. الوصول عبر مفتاح API بنطاق legal:read.
البدء السريع
١) المصادقة — مرّر مفتاحك في الترويسة:
Authorization: Bearer hk_live_XXXXXXXXXXXXXXXX
٢) مثال بحث (cURL):
curl -H "Authorization: Bearer hk_live_XXXX" \ "https://hakeem-platform.vercel.app/api/legal/search?q=%D8%A7%D9%84%D8%A5%D9%8A%D8%AC%D8%A7%D8%B1&limit=10"
٣) مثال (JavaScript):
const res = await fetch("https://hakeem-platform.vercel.app/api/legal/search?q=" + encodeURIComponent("فسخ عقد الإيجار"), {
headers: { Authorization: "Bearer hk_live_XXXX" }
});
const data = await res.json();المسارات المتاحة
| الطريقة | المسار | الوظيفة |
|---|---|---|
| GET | /api/legal/search?q=&limit= | بحث قانوني هجين في النواة (نصّي + دلالي + رسم معرفي) |
| GET | /api/legal/systems?q=&page=&pageSize= | قائمة الأنظمة مع بحث وتصفية وترقيم |
| GET | /api/legal/systems/{id} | تفاصيل نظام ومواده مجمّعة بالفصول |
| GET | /api/legal/articles/{id} | مادة + صيغة الاستناد الرسمية + المعرّف التشريعي (ELI) |
| GET | /api/legal/articles/{id}/related | مواد ذات صلة + الإحالات الداخلية |
| GET | /api/legal/articles/{id}/fiqh | مواءمة فقهية مساندة (غير مُلزِمة، مُعلّمة صراحةً) |
الرموز: 401 مفتاح مفقود/غير صالح · 403 نطاق غير كافٍ · 429 تجاوز حدّ المعدّل · 400 مدخل خاطئ.
كيف تحصل على وصول
١
اطلب مفتاحًا
تواصل مع مسؤول منصّة حكيم للحصول على مفتاح API خاص بك، مع تحديد الاستخدام المتوقّع وحدّ المعدّل المناسب.
٢
مرّر المفتاح
أرسل المفتاح في ترويسة كل طلب: Authorization: Bearer hk_live_… (أو x-api-key).
٣
ابدأ التكامل
استعلم عن الأنظمة والمواد والبحث القانوني. راجع مواصفة OpenAPI للتفاصيل الكاملة.
الحوكمة والحدود
- كل استشهاد بمادة أو حكم يأتي حصرًا من النواة القانونية الرسمية — لا يُختلق مصدر.
- المواءمة الفقهية مساندة وغير مُلزِمة، ومُعلّمة صراحةً في الاستجابة.
- لكل مفتاح حدّ معدّل ونطاق محدّد؛ ويمكن إيقافه في أي وقت.
- المخرجات مرجعية للبحث والتكامل، ولا تُعدّ رأيًا قانونيًا نهائيًا أو حكمًا.