مورد API

المرضى

ملف المريض: البيانات الديموغرافية، التاريخ المرضي/الحساسية، السوابق الطبية والوثائق. كل سجل معزول لعيادتك؛ وعملية الحذف هي أرشفة قابلة للاسترجاع (لا يوجد hard-delete).

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

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

9 نقطة طرفية

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

GET /v1/patients يجلب قائمة المرضى مقسّمة على صفحات جميع الأدوار المصرّح لها

POST /v1/patients ينشئ سجل مريض جديد admin · السكرتير · الطبيب

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

PUT /v1/patients/{id} يحدّث بيانات المريض admin · السكرتير · الطبيب

DELETE /v1/patients/{id} يؤرشف المريض (soft-delete) admin

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

POST /v1/patients/{id}/medical يضيف سجلًا طبيًا/تاريخًا مرضيًا admin · الطبيب

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

POST /v1/patients/{id}/documents يضيف وثيقة إلى المريض admin · السكرتير

مثال استخدام

أنشئ مريضًا جديدًا

الطلب

curl -X POST https://api.udentiva.com/v1/patients \
  -H "Authorization: Bearer udk_live_xxx" \
  -H "Idempotency-Key: 9f1c2e7a-..." \
  -H "Content-Type: application/json" \
  -d '{"first_name":"Ayse","last_name":"Yilmaz","phone":"+90555..."}'

الاستجابة

HTTP/1.1 201 Created
{
  "id": "c0ffee00-1234-...",
  "first_name": "Ayse",
  "last_name": "Yilmaz",
  "phone": "+90555...",
  "created_at": "2026-06-24T09:00:00Z"
}

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

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

عزل البيانات: جميع استعلامات المرضى مقيّدة على مستوى الصفوف (RLS) بالعيادة المرتبطة بالمفتاح؛ ولا يُعاد مريض عيادة أخرى أبدًا.

صلاحية على أساس الدور: الإنشاء/التحديث للمدير أو السكرتير أو الطبيب؛ والحذف للمدير فقط. تُفرَض الصلاحية في طبقة الـ API.

تُقنَّع البيانات الحساسة (TCKN، البيانات الصحية) ولا تُكتب خامًا في سجل التدقيق.

الحذف = soft-delete (deleted_at)؛ يُجهَّل السجل ولا يُحذف فعليًا (متوافق مع KVKK).

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

صيغة الأخطاء

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

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

موارد أخرى

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

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

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

تواصل معنا