مورد API

السياحة الصحية

أدِر رحلة المريض الخارجية من البداية إلى النهاية: تتبّع الحالة، تنسيق النقل/الشحن. يتكامل مع بوابة متعددة اللغات.

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

5 نقطة طرفية

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

GET /v1/tourism-cases يعرض قائمة حالات السياحة العلاجية مستخدم مصرَّح له

POST /v1/tourism-cases ينشئ حالة سياحة مستخدم مصرَّح له

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

GET /v1/shipments يعرض قائمة سجلات النقل/الشحن مستخدم مصرَّح له

POST /v1/shipments ينشئ سجل نقل/شحن مستخدم مصرَّح له

مثال استخدام

أنشئ حالة سياحة

الطلب

curl -X POST https://api.udentiva.com/v1/tourism-cases \
  -H "Authorization: Bearer udk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"patient_id":"c0ffee00-...","country":"DE","language":"de"}'

الاستجابة

HTTP/1.1 201 Created
{
  "id": "tc-12",
  "status": "new",
  "language": "de"
}

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

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

حالات السياحة وسجلات النقل معزولة لعيادتك (RLS).

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

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

صيغة الأخطاء

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

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

موارد أخرى

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

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

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

تواصل معنا