مورد API

المخطط السنّي (Odontogram) والعلاج

خريطة الأسنان FDI، كتالوج الخدمات/الإجراءات، خطة العلاج المرحلية والوصفة الطبية. تُحفظ حالات الأسنان بنمط append-only — لا يُحذف التاريخ ولا يُكتب فوقه.

وصول مبكر كل الـ API

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

14 نقطة طرفية

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

GET /v1/patients/{id}/odontogram يجلب خريطة الأسنان FDI الحالية جميع الأدوار المصرّح لها

POST /v1/patients/{id}/odontogram يضيف حالة سنّ (append-only) admin · الطبيب

GET /v1/patients/{id}/odontogram/{tooth}/history يجلب سجل حالة سنٍّ واحد جميع الأدوار المصرّح لها

GET /v1/services يعرض قائمة كتالوج الخدمات/الإجراءات جميع الأدوار المصرّح لها

POST /v1/services يضيف بند خدمة admin

PUT /v1/services/{id} يحدّث بند الخدمة admin

GET /v1/patients/{id}/plans يعرض قائمة خطط علاج المريض جميع الأدوار المصرّح لها

POST /v1/patients/{id}/plans ينشئ خطة علاج admin · الطبيب

GET /v1/plans/{id} يجلب تفاصيل خطة العلاج جميع الأدوار المصرّح لها

POST /v1/plans/{id}/status يغيّر حالة الخطة admin · الطبيب

POST /v1/plans/{id}/items يضيف مرحلة/بندًا إلى الخطة admin · الطبيب

POST /v1/plan-items/{id}/status يغيّر حالة بند الخطة admin · الطبيب

GET /v1/patients/{id}/prescriptions يعرض قائمة الوصفات الطبية جميع الأدوار المصرّح لها

POST /v1/patients/{id}/prescriptions ينشئ وصفة طبية admin · الطبيب

مثال استخدام

إضافة حالة سنّ (append-only)

الطلب

curl -X POST https://api.udentiva.com/v1/patients/{id}/odontogram \
  -H "Authorization: Bearer udk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"tooth":"11","state":"caries","surface":"mesial"}'

الاستجابة

HTTP/1.1 201 Created
{
  "id": "st-77",
  "tooth": "11",
  "state": "caries",
  "recorded_at": "2026-06-24T09:10:00Z"
}

الأمان في هذا المورد

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

سجلات حالة الأسنان بنمط append-only: كل تغيير يُضاف كصفٍّ جديد، ولا يمكن تعديل السجل القديم (سلامة السجل السريري التاريخي).

إنشاء خطة العلاج والوصفة الطبية متاح لدور المدير/الطبيب فقط؛ وتُنفَّذ منطق السعر والمراحل على الخادم.

جميع السجلات معزولة لعيادتك؛ ولا تُؤخَذ حسابات سعر الخطة من العميل، بل تُجرى على الخادم بنوع numeric.

نموذج الأمان الكامل →

صيغة الأخطاء

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

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

موارد أخرى

المرضى المواعيد والتقويم التحصيل والمالية المخزون التصوير المختبر Lead وCRM السياحة الصحية التقارير وذكاء الأعمال (BI) Webhooks نقل البيانات (Export API)

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

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

تواصل معنا