مورد API

المخزون

بطاقة المخزون، حركة الدخول/الخروج وتنبيه المستوى الحرج. الحركات مسجّلة؛ ويُشتَق الرصيد من الحركات.

النقاط الطرفية

6 نقطة طرفية

النقاط الطرفية العائدة لهذا المورد. تقتصر كل نقطة على بيانات العيادة المرتبطة بمفتاح API؛ وتدعم نقاط الكتابة ترويسة Idempotency-Key.

GET /v1/stock يعرض قائمة بطاقات المخزون جميع الأدوار المصرّح لها

GET /v1/stock/critical يعرض قائمة المخزون عند المستوى الحرج جميع الأدوار المصرّح لها

POST /v1/stock ينشئ بطاقة مخزون admin

PUT /v1/stock/{id} يحدّث بطاقة المخزون admin

POST /v1/stock/{id}/movement يضيف حركة مخزون (دخول/خروج) admin · السكرتير

GET /v1/stock/{id}/movements يعرض قائمة حركات المخزون جميع الأدوار المصرّح لها

اجلب المخزون الحرج

الطلب

curl https://api.udentiva.com/v1/stock/critical \
  -H "Authorization: Bearer udk_live_xxx"

الاستجابة

HTTP/1.1 200 OK
[
  {
    "id": "itm-12",
    "name": "Kompozit A2",
    "on_hand": 3,
    "critical_level": 5
  }
]

الأمان ليس ميزة، بل المعمارية نفسها. الضمانات السارية في هذا المورد:

إنشاء/تحديث بطاقة المخزون للمدير؛ وإضافة الحركة للمدير/السكرتير. جميع البيانات معزولة لعيادتك.

حركات المخزون قائمة على السجلات؛ ويتم التصحيح عبر حركة عكسية، ولا يُحذف التاريخ.

تُعاد الأخطاء بغلاف متسق؛ الرمز موجَّه للآلة والرسالة للمستخدم. لا يُسرَّب الخطأ الداخلي/التتبّع (stack) أبدًا.

{
  "error": {
    "code": "validation_failed",
    "message": "حقل غير صالح: البريد الإلكتروني"
  }
}

هل ترغب في الوصول المبكر؟

كن أول من يعلم عند إتاحة API.