كل ما تريد معرفته عن ليباردو RH
أدلة ومرجع API وWebhooks وSDK لدمج ليباردو RH في أدواتك.
بدء سريع لـ API
أمثلة جاهزة للنسخ
POST /api/v1/auth/login
Content-Type: application/json
{
"email": "manager@acme.com",
"password": "secret",
"device_name": "Mobile App"
}GET /api/v1/auth/me Authorization: Bearer <token>
{
"event": "attendance.checked_in",
"tenant_id": "acme",
"data": {
"employee_id": 42,
"checked_in_at": "2026-05-31T08:00:00Z"
}
}Webhooks فورية
استقبل أحداث الموارد البشرية مباشرة في أنظمتك
تسجيل الحضور
attendance.checked_in
attendance.checked_out
attendance.auto_closed
الغياب
leave.requested
leave.approved
leave.rejected
الرواتب والسلف
salary_advance.requested
salary_advance.paid
payroll.run_completed
الإشعارات
notification.sent
notification.failed
كل حمولة موقّعة بـ X-Leopardo-Signature (HMAC-SHA256). اقرأ التوثيق ←
SDK الجوال Flutter
leopardo_core — الحزمة المشتركة بين التطبيقات الثلاثة
تسجيل الدخول من الكشك (ZKTeco)
جهاز دخول بصمة/QR + جسر سطح مكتب محلي يعمل دون اتصال
التثبيت
- انسخ config.example.json إلى config.json
- املأ apiBaseUrl و deviceCode و kioskToken (تُنشأ من تطبيق المدير)
- شغّل python desktop-bridge/bridge.py على الكمبيوتر المحلي
- افتح الجهاز على http://127.0.0.1:8037/index.html
كيف يعمل
- بصمة أو وجه أو QR/رقم الموظف مع لوحة مفاتيح HID احتياطية
- وضع عدم الاتصال: قائمة SQLite محلية ومزامنة تلقائية عند عودة الشبكة
- إدارة محلية (admin.html) لفرض مزامنة يدوية
- مطابقة البصمة الخام تبقى على جهاز/SDK ZKTeco
الكود المصدري الكامل للجسر وواجهة الكشك: front/zkteco-kiosk/. شاهد صفحة التنزيل ←
الأمان و GDPR
التشفير وعزل المستأجرين والامتثال التنظيمي
التشفير أثناء النقل
جميع الاتصالات عبر TLS 1.3. لا تبادل نصي صريح بين العملاء وAPI والأجهزة.
التشفير عند التخزين
البيانات الحساسة مشفرة بـ AES-256. البيانات البيومترية تبقى على الجهاز؛ لا تنتقل سوى التجزئات.
عزل المستأجرين
مخطط PostgreSQL معزول لكل شركة. الوصول محكوم بـ RBAC (Principal و HR و موظف و Super Admin).
الامتثال لـ GDPR
استضافة أوروبية وسجل تدقيق كامل وتصدير وحذف متوافق مع GDPR للبيانات الشخصية.
تثبيت التطبيقات الجوالة
Employee و Manager و Platform Admin — iOS و Android
Leopardo Employee
حضور جوال وتحديد المواقع وكشوف رواتب وطلبات غياب وإشعارات فورية.
Google Play و App Store: قريبًا.
انضم إلى المختبرينLeopardo Manager
الفريق والجداول والمهام وموافقات الطلبات ورواتب مبسطة من الميدان.
Google Play و App Store: قريبًا.
انضم إلى المختبرينLeopardo Platform Admin
إنشاء المستأجرين والإشراف على الشركات العميلة وتجهيز 2FA.
Google Play و App Store: قريبًا.
انضم إلى المختبرينمزيد من التفاصيل حول التطبيقات الثلاثة: صفحة التطبيقات الجوالة ←.