مورد API

Lead وCRM

اجمع الطلبات الواردة (lead) في حوض واحد؛ تابِع المهام والمكالمات وتواصل المرضى. لا يضيع أي اهتمام في الطريق.

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

7 نقطة طرفية

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

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

POST /v1/leads ينشئ lead جديدًا مستخدم مصرَّح له

POST /v1/leads/{id}/status يغيّر حالة/مرحلة الـ lead مستخدم مصرَّح له

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

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

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

POST /v1/messages ينشئ سجل رسالة/تواصل مستخدم مصرَّح له

مثال استخدام

حدّث حالة الـ lead

الطلب

curl -X POST https://api.udentiva.com/v1/leads/{id}/status \
  -H "Authorization: Bearer udk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"status":"qualified"}'

الاستجابة

HTTP/1.1 200 OK
{
  "id": "ld-88",
  "status": "qualified"
}

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

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

سجلات الـ lead والتواصل معزولة لعيادتك (RLS).

استقبال الـ lead العام (landing) هو نقطة منفصلة، بلا جلسة ومحدودة السرعة؛ ويُمنَع البريد العشوائي عبر حد نافذة Redis.

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

صيغة الأخطاء

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

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

موارد أخرى

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

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

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

تواصل معنا