مورد API

المواعيد والتقويم

جدولة على أساس الطبيب والكرسي، منع الحجز المزدوج، تذكير آلي وقائمة انتظار. يُمنَع التعارض على مستوى قاعدة البيانات.

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

10 نقطة طرفية

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

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

POST /v1/appointments ينشئ موعدًا جديدًا (مع فحص التعارض) admin · السكرتير · الطبيب

POST /v1/appointments/{id}/status يغيّر حالة الموعد admin · السكرتير · الطبيب

POST /v1/appointments/{id}/reschedule يعيد جدولة الموعد admin · السكرتير · الطبيب

POST /v1/appointments/{id}/remind يرسل تذكيرًا بالموعد admin · السكرتير · الطبيب

GET /v1/units يعرض قائمة الكراسي/الوحدات جميع الأدوار المصرّح لها

GET /v1/doctors يعرض قائمة الأطباء جميع الأدوار المصرّح لها

GET /v1/waitlist يجلب قائمة الانتظار جميع الأدوار المصرّح لها

POST /v1/waitlist يضيف مريضًا إلى قائمة الانتظار admin · السكرتير · الطبيب

DELETE /v1/waitlist/{id} يزيل من قائمة الانتظار admin · السكرتير · الطبيب

مثال استخدام

اجلب المواعيد حسب نطاق التاريخ

الطلب

curl https://api.udentiva.com/v1/appointments?from=2026-06-24&to=2026-06-25 \
  -H "Authorization: Bearer udk_live_xxx"

الاستجابة

HTTP/1.1 200 OK
[
  {
    "id": "a1b2...",
    "patient_id": "c0ffee00-...",
    "unit_id": "u-1",
    "starts_at": "2026-06-24T10:00:00Z",
    "ends_at": "2026-06-24T10:30:00Z",
    "status": "confirmed"
  }
]

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

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

الحجز المزدوج مستحيل على مستوى قاعدة البيانات عبر exclusion constraint؛ فحتى لو وقع خطأ في التطبيق لا يمكن كتابة موعد متعارض.

يُمنَع التسابق على الخانات الزمنية المتزامنة عبر قفل Redis الموزّع؛ لا يمكن لطلبين الكتابة في الخانة ذاتها في آنٍ واحد.

جميع بيانات المواعيد معزولة لعيادتك (RLS)؛ وتُسجَّل تغييرات الحالة في سجل التدقيق.

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

صيغة الأخطاء

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

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

موارد أخرى

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

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

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

تواصل معنا