لا عنوان عام. الاستدعاء يستخدم المضيف الذي يقدّم هذه المسودة. فتح هذه اللوحة لا ينشئ رمزاً.

الجلسة هي كعكة imma_session أو Bearer للجلسة. رموز الوكيل تُرفض عند كتابة العملاء أو المخزون. الصحة لا تشترط جلسة.

المنظمة تأتي من الجلسة. معرّف المنظمة الذي يرسله العميل يُتجاهل.

جلسة الكعكة التي تكتب يجب أن ترسل الترويسة x-imma-request بالقيمة 1. جلسة Bearer لا تستخدمها. GET لا يطلبها.

GET العملاء يحتاج customers.read. POST يحتاج customers.write. POST المخزون يحتاج inventory.adjust وهو للمالك والإدارة فقط. المكتبة تحتاج جلسة. قدرات الوكيل تحتاج رمز وكيل وتعيد النطاقات فقط.

POST /api/v1/inventory يكرر الجرد عند نفس idempotencyKey ونفس المحتوى. مفتاح معاد بمحتوى مختلف يعيد 409. إنشاء العميل بلا مفتاح تماثل.

الاستعادة تقبل 3 طلبات في الساعة لعنوان ولا تقول إن كان موجوداً. أعمال الوكيل تتوقف عند 30 في الساعة لذلك الرمز. بقية المسارات المركّبة بلا حد HTTP.

لا مسار مركّب يسجّل أو يستقبل نداءات. فحوص التوقيع في مجال الخادم وهذا الزر لا يفتحها.

إصدار رمز خدمة وإلغاؤه يتطلبان مالكاً أو مديراً مصادقاً ويبقيان داخل تلك المنظمة. هذا الترويسة لا تصدر رمزاً ولا تعرضه ولا تلغيه. التدوير غير منفّذ.

POST /api/v1/agent/jobs مركّب لرمز وكيل يملك jobs.write. مثال Bearer اصطناعي وليس مفتاحاً حياً. هذه اللوحة لا تنشئ رمزاً.

• GET /api/health · يفحص القاعدة. بلا جلسة. بلا سلسلة اتصال.
• GET /api/v1/health · يفحص القاعدة والأعلام المطفأة. بلا جلسة.
• GET /api/v1/openapi · وثيقة للآلة. ناقصة. انظر الفجوة أعلاه.
• GET /api/v1/customers · يسرد عملاء منظمة الجلسة.
• POST /api/v1/customers · ينشئ عميلاً. الحقلان code وname. organizationId في الجسم يُتجاهل.
• POST /api/v1/inventory · تسوية جرد. الحقول warehouseId وproductId وcountedQty وdate وidempotencyKey. الأمثلة أدناه اصطناعية.
• GET /api/v1/library/search · استعلام q. مكتبة بلا شبكة. ليس نصاً نافذاً.
• GET /api/v1/library/citation · استعلام q وlocale اختياري. إن لم يوجد استشهاد يُعاد رمز الخطأ.
• GET /api/v1/library/coverage · أعداد التغطية. ليست إجازة قانونية.
• GET /api/v1/agent/capabilities · يعيد نطاقات رمز الوكيل المتصل. لا يصدر رمزاً.
• GET /api/v1/agent/jobs · يصف عملاً محلياً لرمز وكيل يملك jobs.write. الحصة 30 في الساعة. رمز الجلسة يُرفض.
• POST /api/v1/agent/jobs · يصف عملاً محلياً لرمز وكيل يملك jobs.write. الحصة 30 في الساعة. رمز الجلسة يُرفض.

مثال اصطناعي. ليست بيانات اعتماد حقيقية.

SYNTHETIC
Authorization: Bearer imma_sess_EXAMPLE
x-imma-request: 1
{"code":"C-EXAMPLE","name":"Example","organizationId":"ignored"}
{"warehouseId":"00000000-0000-0000-0000-000000000000","productId":"00000000-0000-0000-0000-000000000000","countedQty":"1","date":"2026-11-08","idempotencyKey":"example-count-1"}