Clinic API
واجهة الربط الموحّدة لعيادات الجمال الأفضل — فوق نظام Kizen · الإصدار 2.0
Kizen للقراءة فقط عبر هذه الواجهة. لا يوجد endpoint واحد يكتب في قاعدة بيانات المورّد.
طلبات إنشاء مريض أو حجز موعد تدخل طابور مراجعة يعتمده موظف العيادة ثم يُدخله من برنامج Kizen نفسه،
حتى تبقى قواعد البرنامج وترقيمه وسجل تدقيقه سليمة.
المصادقة
كل طلب يحمل ترويسة
Authorization: Bearer <API_KEY> (أو
X-API-Key).
كل نظام مربوط له
عميل خاص بمفاتيحه وصلاحياته وحدّ استخدامه، فيمكن إيقاف أحدها دون المساس بالباقي.
curl -H "Authorization: Bearer $KEY" https://kizenapi.o2m8.me/v1/admin/whoami
الصلاحيات (Scopes)
المفتاح لا يرى إلا ما مُنح له. أداة التسويق تأخذ
analytics:read و
leads:write
فتعجز بنيوياً عن قراءة أي سجل طبي.
adminanalytics:readappointments:readappointments:writecatalog:readclinical:readenrichment:readenrichment:writefinancials:readleads:writemessages:readpatients:readpatients:write
ملاحظات على البيانات
- مبالغ الفواتير محسوبة من بنود الفاتورة، لأن عمود الإجمالي في Kizen فارغ في كل الصفوف.
- المرتجعات مسجّلة كقيم سالبة، فالمجاميع صافية أصلاً.
- حالة الموعد تُقرأ من الحقل الذي تحدّثه العيادة فعلاً — نسبة عدم الحضور التاريخية ≈ 23%.
- الأوقات المحجوزة (
Block) ليست مواعيد وتُستبعد افتراضياً.
- الأرقام تُعاد بصيغة موحّدة
9665XXXXXXXX مهما كانت طريقة إدخالها.
- مصدر العميل والإيميل والواتساب والموافقات تعيش في مخزننا لا في Kizen — عبر
/enrichment.
الـ Endpoints
المزامنة
Kizen لا يملك حقل "آخر تعديل" صالحاً، لذا المزامنة تعتمد على معرّف تصاعدي + إعادة قراءة نافذة زمنية
تلتقط التعديلات على الصفوف القديمة.
GET /v1/sync/changes?entity=appointments&since_id=97400&window_days=30
احفظ
next_since_id من الرد ومرّره في الطلب التالي.
العقد التقني