ترجمة عربية لأغراض الاطلاع فقط، والمرجع المعتمد هو النص الروسي الأصلي.
CasusLegalمجموعة اجتهادات المحاكم العليا ← إلى الصفحة الرئيسية
API · الوصول بالاتفاق

API CasusLegal

اجتهادات المحاكم العليا مباشرةً في شفرتكم


بحث دلالي في اجتهادات المحاكم العليا بوصفه أداة خارجية. يُوصَل بتطبيقكم القائم على أي LLM أو بأي عميل HTTP. يعيد الطلب الواحد أحكاماً وقرارات حقيقية مع بياناتها المرجعية واقتباساتها وروابط النص الكامل.

مراسلة المسؤول الحساب الشخصي الوثائق
انتهى العرض الترويجي المجاني عند الإطلاق

انتهى الوصول الترويجي (300 طلب خلال 10 أيام) 27 يونيو 2026. لا تُصدر مفاتيح جديدة تلقائياً في الوقت الراهن، ولا توجد حزم مدفوعة لـ API حتى الآن. وتصف الشروط أدناه العرض الترويجي وقد أُبقيت للرجوع إليها: نفتح الوصول يدوياً — اكتب إلى المسؤول في @CasusLegalBot أو في قسم «الرسائل» في الحساب الشخصي. الوثائق وأمثلة الشفرة محدثة.

ما هذا؟

باختصار: ما يستطيع الموصل فعله بالفعل داخل Claude أو ChatGPT أو Grok أو Hermes الخاص بكم، يمكن الآن دمجه في منتجكم الخاص.

مفتاح API عبارة عن سلسلة سرية طويلة تبدأ بـ cl_live_ (مثل، cl_live_QZbj…). تُدرجونها في شفرتكم، فتتيح لخادمكم أو تطبيقكم الوصول إلى اجتهادات المحكمة الدستورية للاتحاد الروسي، والمحكمة العليا للاتحاد الروسي، والمحكمة العليا للتحكيم (أربيتراج) للاتحاد الروسي. ويشمل ذلك نحو 27 000 قراراً وحكماً أصلياً منذ عام 1992 وحتى اليوم.

ترسلون طلب HTTP عادياً وتتلقون في المقابل أحكاماً وقرارات حقيقية: البيانات المرجعية، والاقتباسات الحرفية، وروابط النص الكامل. لا قرارات مختلقة.

احتفظوا بالمفتاح ككلمة مرور

يُعرض المفتاح مرة واحدة عند إنشائه، لذا احفظوه فوراً. نحن نحتفظ فقط بتجزئة المفتاح؛ ولا يمكن استعادة المفتاح نفسه. احتفظوا به على خادمكم، ولا تضمنوه في موقع إلكتروني أو تطبيق للهواتف المحمولة أو مستودع عام. إذا تسرّب المفتاح، فألغوه في الحساب وتواصلوا مع قسم «الرسائل» للاتفاق على استبداله.

شروط العرض الترويجي عند الإطلاق (انتهى)

خلال الفترة الترويجية، كان هناك حد مجاني موحّد. انتهى العرض في 27 يونيو 2026 — وأُبقيت الأرقام أدناه للرجوع إليها.

300
الطلبات
10
أيام منذ التفعيل
1
مفتاح نشط
0 ₽
مجاناً

لـ API شروط وصول منفصلة. ولا تُحتسب حزم الطلبات الخاصة بالروبوت والدردشة على الويب على API. ولا تُباع حزم API المدفوعة في الوقت الراهن؛ ويُتفق يدوياً على إمكانية الوصول والحدود من خلال «الرسائل» في الحساب الشخصي.

ما الذي يتيحه المفتاح؟

كيفية خصم الطلبات

لا تُستهلك أموال العرض الترويجي، لكن يُحتسب الرصيد البالغ 300 طلب على النحو الآتي.

يُخصم طلب واحد

  • البحث في الاجتهادات
  • الفهرس المختار
  • البحث عن عبارة مطابقة تماماً
  • البحث عن قضايا مشابهة

مجاناً، ولا يمسّ الرصيد

  • فتح بطاقة القرار
  • تنزيل النص الكامل
  • إنشاء مجموعة مختارة وتنزيلها
  • قائمة الموضوعات والإحصاءات
ملاحظتان واضحتان

لا يُخصم الطلب إلا إذا نُفّذ بنجاح: فإذا وقع عطل من جانبنا أو نفد الرصيد، فلا يُستهلك أي شيء. وهناك حدّ مرن للسرعة، يبلغ نحو 20 طلباً في الدقيقة: وهو لا يستهلك الرصيد، بل يخفف من حدة الارتفاعات المفاجئة.

ما لا يتيحه المفتاح

حتى يكون الأمر واضحاً ومطمئناً.

أين يمكن الاستفادة منه؟

موقع شركة محاماة أو خدمة إلكترونية

يُدخل العميل سؤالاً ويرى مجموعة مختارة من القرارات الحقيقية مع الروابط. ويعمل البحث على أساس المعنى، ولذلك يناسب غير المتخصصين في القانون أيضاً.

روبوت دردشة أو مساعد خاص بكم

لا يجيب الروبوت «من عنده»، بل يجيب مع روابط إلى قضايا محددة. ويعالج المشكلة الأساسية: القرارات المختلقة.

RAG وتدريب النماذج

استدعوا النص الكامل للقرارات بصيغة Markdown بوصفه سياقاً للآراء القانونية ومشروعات الوثائق والإجابات.

إعداد الوثائق

اعثروا على القرارات، ونزّلوا المجموعة المختارة بصيغة DOCX، وأدرجوها في صحيفة دعوى أو مذكرة جوابية أو مذكرة قانونية. وتنتهي ساعات النسخ اليدوي.

التحليلات والرصد

طلبات جماعية بحسب الموضوعات والقواعد والسنوات، وإحصاءات المجموعة، ورصد منتظم لأحدث مواقف الدوائر القضائية.

الأنظمة الداخلية للشركة

الاجتهادات في قاعدة المعرفة أو نظام CRM للإدارة القانونية أو نظام اعتماد العقود، مباشرةً حيث يجري العمل.

الوثائق

دليل للمطورين

التوصيل، ونقاط النهاية، ومعالجة الأخطاء، وإعداد LLM الخاص بكم. المجموعة: المحكمة الدستورية للاتحاد الروسي (1992–2026)، والمحكمة العليا للاتحاد الروسي (2014–2026)، والمحكمة العليا للتحكيم (أربيتراج) للاتحاد الروسي (1992–2014)، ونحو 27 000 قراراً وحكماً أصلياً.

الربط

هذا REST-API. يُوصَل بتطبيقكم القائم على أي LLM أو بأي عميل HTTP بوصفه أداة خارجية تستدعيها نماذجكم للبحث في الاجتهادات القضائية.

Base URL: https://lk.casus.legal

المصادقة: العنوان Authorization: Bearer cl_live_…

التنسيق: JSON عبر HTTPS.

لا تخلطوه مع موصل MCP

العنوان https://mcp.casus.legal/one/mcp — فهذا موصل MCP مستقل لمساعدي الذكاء الاصطناعي (Claude وChatGPT وGrok وHermes). ولا علاقة له بـ REST-API أو بالمفاتيح cl_live_ على الإطلاق.

1. الحصول على المفتاح

  1. سجّلوا الدخول إلى الحساب الشخصيعبر Telegram أو باستخدام البريد الإلكتروني وكلمة المرور، إلى الحساب نفسه المستخدم للروبوت والدردشة على الويب.
    قسم «API»
  2. اطلبوا الوصول عبر «الرسائل»صفوا المهمة والحجم المتوقع للطلبات. لقد أُغلق الإصدار الذاتي للمفاتيح الجديدة.
    مراسلة المسؤول
  3. انتظروا الموافقة على الشروطسيُبلغ المسؤول بإمكانية التفعيل والحدود وإجراءات الحصول على المفتاح. احفظ المفتاح الذي حصلت عليه cl_live_… فورًا؛ إذ لا يمكن استعادته. ولا يتيح شراء حزمة الدردشة استخدام API.
تتبّع المفاتيح وحدودها

تظهر المفاتيح الحالية وعداداتها في قسم «API» في الحساب الشخصي. ولا يعني وجود المفتاح بحد ذاته أن الوصول فعال. اتفق على تمديد المفتاح واستبداله عبر «الرسائل»؛ ولا يؤدي سحب المفتاح إلى إتاحة إصدار مفتاح جديد بصورة مستقلة.

2. الطلب الأول

bash · curl
curl -X POST https://lk.casus.legal/v1/search \
  -H "Authorization: Bearer $CASUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "договор энергоснабжения, фактическое потребление", "limit": 15}'
python · httpx
import os, httpx

client = httpx.Client(
    base_url="https://lk.casus.legal",
    headers={"Authorization": f"Bearer {os.environ['CASUS_API_KEY']}"},
    timeout=60,
)

r = client.post("/v1/search", json={
    "query": "снижение неустойки по статье 333 ГК",
    "limit": 15,
    "mode": "hybrid",
})
r.raise_for_status()
data = r.json()
for hit in data["results"]:
    print(hit["court"], hit["date"], hit["case_number"], hit["url"])

3. نقاط النهاية

POST /v1/searchيُخصم طلب واحد

بحث هجين. لا يُخصم طلب واحد إلا عند ورود استجابة ناجحة.

الحقلالنوعالافتراضيالوصف
querystringإلزاميالطلب باللغة الروسية. يؤدي تركه فارغًا إلى إرجاع 400.
limitint 1–3010حجم النتائج. يُوصى بـ 15–20 للاستعراض.
modehybrid / bm25 / semantichybridhybrid (يوصى باستخدام BM25 والدلالات).
courtstring–التصفية: المحكمة الدستورية للاتحاد الروسي / المحكمة العليا للاتحاد الروسي / المحكمة العليا للتحكيم (أربيتراج) للاتحاد الروسي / الدائرة القضائية للمنازعات الاقتصادية / الدائرة القضائية للقضايا المدنية / الهيئة العامة / استعراض.
act_type, tag, articlestring–مرشحات إضافية (article، مثل المادة 333 من القانون المدني للاتحاد الروسي).
year_from, year_toint–نطاق السنوات.
deduplicatebooltrueدمج التكرارات الخاصة بالقضية الواحدة.
expandbooltrueتوسيع الطلب باستخدام المرادفات.

تُرجع بنية الاستجابة كتلًا جاهزة وفق تسلسل المحاكم الهرمي. كوّن الاستجابة منها، ولا تُجرِ طلبًا منفصلًا لكل محكمة.

json · استجابة /v1/search
{
  "_response_format_hint": "…директива формата ответа…",
  "constitutional_context": { "items": [ … ] },   // المحكمة الدستورية للاتحاد الروسي
  "vs_guidance":            { "items": [ … ] },   // الهيئات العامة والاستعراضات للمحكمة العليا للاتحاد الروسي
  "latest_practice":        { "items": [ … ] },   // أحدث قرارات دوائر المحكمة العليا للاتحاد الروسي
  "vas_history":            [ … ],                // التاريخ: اجتهاد المحكمة العليا للتحكيم (أربيتراج) للاتحاد الروسي
  "results": [
    {
      "id": 12345, "court": "СКЭС", "date": "10.05.2024",
      "case_number": "305-ЭС24-12345", "title": "…", "snippet": "…",
      "score": 0.87,
      "url": "https://lk.casus.legal/case/12345?t=<токен>"
    }
  ],
  "_supersession_alert": "…",   // عند وجود قرار ملغى وقرار نافذ
  "expansion": { … }
}
حقل url

في حقل url يوجد لكل قرار رابط جاهز للنص الكامل مرفق برمز وصول ?t=…. استخدمه حرفيًا: لا تُنشئ الرابط من id ولا تحذف الرمز.

GET /v1/cases/{id}مجاناً

بطاقة القرار: البيانات، sections (النص بحسب الأقسام)، articles, hashtags والروابط url / url_md / url_docx. استخدمه للاقتباسات الحرفية من القرارات الأساسية. ولا يستهلك من الحصة.

bash · curl
curl https://lk.casus.legal/v1/cases/12345 \
  -H "Authorization: Bearer $CASUS_API_KEY"

4. الأخطاء والحدود

تَرِد جميع الأخطاء بصيغة JSON {"error": "<код>", "message": "…"}.

HTTPerrorمتىما الذي ينبغي فعله
400bad_requestلا يوجد query أو JSON تالفصحّح نص الطلب
401unauthorizedالمفتاح غير موجود أو غير صحيح أو مسحوبتحقق من الترويسة والمفتاح
402quota_exhaustedانتهى الوصول الترويجي (في نص reason, message, contact_url)اكتب إلى المسؤول عبر @CasusLegalBot لتمديده
403forbiddenالمفتاح لا يتيح الوصول إلى البحثنسّق الوصول عبر «الرسائل» في الحساب
404not_foundقرار يحمل هذا id غير موجود–
429rate_limitedتم تجاوز حد الطلبات في الدقيقةالتراجع الأسي
500internal_errorعطل من جانبناأعد المحاولة مع التراجع، ولا يُخصم الطلب
503engine_not_readyإعادة النشر أو تهيئة الفهرسأعد المحاولة بعد 1–3 دقائق
التتبّع

POST /v1/search يُخصم طلب واحد عند ورود الاستجابة فقط 200: لا تُحتسب الأخطاء. GET /v1/cases/{id} مجاني. يُحتسب حد الطلبات في الدقيقة لكل مفتاح (20 طلبًا في الدقيقة خلال الفترة التجريبية). ويظهر الرصيد المتبقي من الحصة في قسم «API» في الحساب الشخصي.

5. أفضل الممارسات

  • المفتاح في الواجهة الخلفية فقط. احفظه في متغيرات البيئة أو الأسرار، لا في الشفرة ولا في Git ولا على جانب العميل.
  • إعادة المحاولة بتأخير أسي. في 429 و 5xx أعد المحاولة بفواصل متزايدة: 2 ث، 4 ث، 8 ث.
  • خزّن البطاقات مؤقتًا. المحتوى GET /v1/cases/{id} مستقر، والاستدعاء مجاني.
  • لا تعدّل الروابط. الحقل url موقّع برمز صالح لمدة تقارب 30 يومًا. أرسله كما هو.

إعداد LLM الخاص بك

تُرجع API المواد الخام: بطاقات القرارات والكتل الموضوعية وتلميح تنسيق _response_format_hint. وتحدد التعليمات النظامية الخاصة بـ LLM جودة الاستجابة النهائية. وفيما يلي مبادئ لسيناريوهين، وليست مطالبات جاهزة.

السيناريو A. الاستجابة في الدردشة (استعراض الاجتهاد القضائي)

  1. بحث واحد، وقيمة limit كبيرة. يكفي استدعاء واحد /v1/search بطلب واضح المعنى و limit 15–20: إذ تَرِد هرمية المحاكم في كتل بالفعل. لا تقسّم الموضوع إلى طلبات لكل محكمة.
  2. مرّر إلى النموذج _response_format_hint. هذه توجيهة تنسيق مضمّنة، ويؤدي أخذها في الاعتبار إلى تقريب الاستجابة بوضوح من الاستعراض النموذجي.
  3. دور «مرجع، لا مستشار». أدرج جميع القرارات ذات الصلة وفق التسلسل الهرمي (أولوية المحكمة الدستورية للاتحاد الروسي، وحداثة المحكمة العليا للاتحاد الروسي، والمحكمة العليا للتحكيم (أربيتراج) للاتحاد الروسي بوصفها تاريخًا)، من دون توصية نهائية ومن دون اختيار «الموقف الصحيح الوحيد» نيابةً عن المستخدم.
  4. الروابط من الحقل فقط url. امنع إنشاء العنوان من id وحذف الرمز ?t=: فمن دونه لن يفتح الرابط النص.
  5. الاقتباسات باعتدال. استخرج الاقتباسات الحرفية عبر /v1/cases/{id} لثلاثة إلى خمسة قرارات أساسية فقط. أما لدى المحكمة الدستورية للاتحاد الروسي، فالاقتباس المطلوب موجود بالفعل في الحقل المضمّن position. فهذا هو المصدر الرئيسي للرموز الزائدة.
  6. من النتائج فقط. امنع استكمال الاجتهاد القضائي من الذاكرة: فما ليس في استجابة API «غير موجود في قاعدة البيانات».

السيناريو B. إعداد فهرس الاجتهاد القضائي

الهدف: مجموعة أو قائمة قضايا للتصدير، من دون تحليل قانوني.

  1. ضيّق النطاق أولًا باستخدام المرشحات. دع النموذج يوضّح الموضوع ويطبّق المرشحات court / act_type / tag / article / year_from–year_to: فسيصبح الفهرس ملائمًا وموجزًا.
  2. جمع بلا تحليل. استخرج لكل قرار idالبيانات (المحكمة، النوع، التاريخ، رقم القضية) و url. لا تُعد سرد القرارات ولا تقتبس منها في هذا الوضع.
  3. اكتمال عبر عدة طلبات. بالنسبة إلى موضوع واسع، أجرِ عدة /v1/search حسب الموضوعات الفرعية أو السنوات أو المحاكم، وادمج النتائج بعد حذف التكرارات وفق id.
  4. أخرج قائمة لا استنتاجًا. نتيجة هذا الوضع: جدول أو قائمة بروابط urlيتولى المستخدم تصفيتها بنفسه.
  5. فصل واضح بين الوضعين. افصل هذا الوضع صراحةً عن السيناريو A، حتى لا ينزلق النموذج إلى تحليل موسّع عندما تكون المطلوب مجموعة مختارة.
عربي