مورد API

المختبر

أنشئ طلبات المختبر وتابِع حالتها من البداية إلى النهاية؛ أدِر المختبرات المتعاقد معها. اكتشف التأخيرات مبكرًا.

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

7 نقطة طرفية

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

GET /v1/lab-orders يعرض قائمة طلبات المختبر مستخدم مصرَّح له

POST /v1/lab-orders ينشئ طلب مختبر مستخدم مصرَّح له

GET /v1/lab-orders/{id} يجلب تفاصيل الطلب مستخدم مصرَّح له

PUT /v1/lab-orders/{id} يحدّث الطلب مستخدم مصرَّح له

POST /v1/lab-orders/{id}/status يغيّر حالة الطلب مستخدم مصرَّح له

GET /v1/labs يعرض قائمة المختبرات المتعاقد معها مستخدم مصرَّح له

POST /v1/labs يضيف مختبرًا مستخدم مصرَّح له

مثال استخدام

أنشئ طلب مختبر

الطلب

curl -X POST https://api.udentiva.com/v1/lab-orders \
  -H "Authorization: Bearer udk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"patient_id":"c0ffee00-...","lab_id":"lab-3","type":"crown"}'

الاستجابة

HTTP/1.1 201 Created
{
  "id": "lo-204",
  "status": "created",
  "created_at": "2026-06-24T09:25:00Z"
}

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

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

طلبات المختبر وسجلات المختبر معزولة لعيادتك (RLS).

تتم انتقالات الحالة عبر action endpoint وتُسجَّل في سجل التدقيق.

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

صيغة الأخطاء

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

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

موارد أخرى

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

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

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

تواصل معنا