مورد API

التصوير

تُربَط الأشعة والصور السريرية بملف المريض. تُحفظ الملفات في تخزين كائنات متوافق مع S3؛ وليس في قاعدة البيانات أبدًا.

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

3 نقطة طرفية

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

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

POST /v1/patients/{id}/images يرفع صورة (S3، stream/presigned) admin · الطبيب · السكرتير

GET /v1/images/{id}/raw ينزّل ملف الصورة (presigned) جميع الأدوار المصرّح لها

مثال استخدام

اعرض قائمة صور المريض

الطلب

curl https://api.udentiva.com/v1/patients/{id}/images \
  -H "Authorization: Bearer udk_live_xxx"

الاستجابة

HTTP/1.1 200 OK
[
  {
    "id": "img-55",
    "kind": "panoramic",
    "url": "https://s3.../signed?expires=...",
    "created_at": "2026-06-24T09:20:00Z"
  }
]

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

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

الملفات الكبيرة (الأشعة) لا تُكتب على قرص الـ BFF؛ بل تُنقل مباشرة إلى S3 عبر stream/presigned.

يُتاح الوصول إلى الملف الخام عبر رابط موقّع مؤقت (presigned)؛ فحتى لو تسرّب الرابط تنتهي صلاحيته.

جميع الصور معزولة للمريض وللعيادة (RLS)؛ ولا تستطيع عيادة غير مصرَّح لها الوصول.

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

صيغة الأخطاء

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

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

موارد أخرى

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

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

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

تواصل معنا