غلاف واجهة BioTime API
آخر تحديث: 28/8/2026
غلاف واجهة BioTime API
لدى كثير من العملاء بالفعل تكامل يعمل (JISR، Odoo، سكربت رواتب مخصص) مبني على واجهة REST API الخاصة بنظام ZKTeco BioTime نفسه. بدلًا من إعادة كتابة ذلك التكامل، يمكن لـ EasyTime أن يعرض مجموعة فرعية حقيقية ومتوافقة من واجهة BioTime نفسها — نفس المسارات، نفس مخطط المصادقة، نفس أشكال الاستجابة — بحيث يعمل التكامل الحالي مقابل EasyTime دون أي تعديل.
تفعيله
- اذهب إلى الإعدادات ← التكاملات ← BioTime API.
- فعّل خيار تفعيل غلاف BioTime API.
- اضبط اسم مستخدم BioTime — يجب أن يكون فريدًا عبر جميع الشركات على مثيل EasyTime هذا، لأن الطلب الوارد يحمل فقط اسم مستخدم/كلمة مرور، دون سياق شركة.
- اضبط كلمة مرور BioTime.
- احفظ. تعرض لوحة مرجع نقاط النهاية عناوين URL الأساسية الدقيقة لتسليمها لمُكامِلك.
المصادقة
تمامًا مثل نشر BioTime حقيقي — مصادقة رمز DRF القياسية، وليست مخطط Bearer/JWT الذي تستخدمه واجهة EasyTime الخاصة بها.
POST /api-token-auth/
Content-Type: application/json
{"username": "acme_biotime", "password": "your-password"}
الاستجابة: {"token": "<سلسلة hex من 40 حرفًا>"} — رمز ثابت، لا يُعاد إصداره مع كل تسجيل دخول. استخدمه
في كل استدعاء آخر:
Authorization: Token <token>
نقاط النهاية المدعومة
جميع نقاط النهاية القائمة على القوائم مُرقّمة الصفحات: {"count", "next", "previous", "msg", "code", "data": [...]}
(معاملات استعلام page/page_size، الافتراضي 10، والحد الأقصى 100 لكل صفحة) — تطابق تمامًا
مظروف الترقيم الحقيقي الخاص بـ BioTime نفسه، وليس مصفوفة results البسيطة التي تستخدمها واجهة
EasyTime في أماكن أخرى.
الموظفون — /personnel/api/employees/
| الطريقة | المسار | ملاحظات |
|---|---|---|
| GET | /personnel/api/employees/ | قائمة، مُرقّمة الصفحات |
| GET | /personnel/api/employees/{id}/ | تفصيل |
| POST | /personnel/api/employees/ | إنشاء |
| PUT | /personnel/api/employees/{id}/ | تحديث |
| DELETE | /personnel/api/employees/{id}/ | إلغاء تفعيل |
| POST | /personnel/api/employees/adjust_area/ | إعادة تخصيص المنطقة (منطقة/مناطق) جماعيًا — {"employees":[ids],"areas":[ids]} |
| POST | /personnel/api/employees/adjust_department/ | إعادة تخصيص القسم جماعيًا — {"employees":[ids],"department":id} |
| POST | /personnel/api/employees/adjust_position/ | إعادة تخصيص المنصب جماعيًا — {"employees":[ids],"position":id} |
| POST | /personnel/api/employees/adjust_resign/ | إنهاء خدمة جماعي — {"employees":[ids],"resign_date","resign_type","reason","disableatt"} |
| POST | /personnel/api/employees/del_bio_template/ | حذف بصمات الإصبع/الوجه (محليًا + يدفع حذفًا حقيقيًا على الجهاز) |
| POST | /personnel/api/employees/resync_to_device/ | فرض إعادة دفع جديدة لأجهزة هذا الموظف |
الأقسام / المناطق / المناصب — عمليات CRUD كاملة، بنفس الشكل لكل منها:
/personnel/api/departments/، /personnel/api/areas/، /personnel/api/positions/
(GET قائمة، GET تفصيل، POST إنشاء، PUT تحديث، DELETE).
إنهاءات الخدمة — /personnel/api/resigns/
| الطريقة | المسار | ملاحظات |
|---|---|---|
| GET / POST | /personnel/api/resigns/ | قائمة / إنشاء — {"employee":id,"resign_date",...} |
| GET / PUT / DELETE | /personnel/api/resigns/{id}/ | تفصيل / تحديث / حذف |
| POST | /personnel/api/resigns/reinstatement/ | إعادة تفعيل — {"resigns":[resign-row-ids]} |
الأجهزة الطرفية (الأجهزة) — /iclock/api/terminals/
| الطريقة | المسار | ملاحظات |
|---|---|---|
| GET / POST | /iclock/api/terminals/ | قائمة / إنشاء |
| GET / PUT / DELETE | /iclock/api/terminals/{id}/ | تفصيل / تحديث / حذف |
| POST | /iclock/api/terminals/clear_command/ | مسح الأوامر المعلّقة — {"terminals":[ids]} |
| POST | /iclock/api/terminals/clear_capture/ | مسح البيانات الحيوية الملتقطة من هذه الأجهزة |
| POST | /iclock/api/terminals/clear_all/ | مسح جميع بيانات الجهاز (أمر CLEAR DATA حقيقي) |
| POST | /iclock/api/terminals/upload_all/ | فرض إعادة سحب كاملة للمستخدمين/القوالب/الصور |
| POST | /iclock/api/terminals/upload_transaction/ | فرض إعادة سحب بيانات الحضور |
| POST | /iclock/api/terminals/reboot/ | إعادة تشغيل عن بُعد |
المعاملات (الحضور) — /iclock/api/transactions/
| الطريقة | المسار | ملاحظات |
|---|---|---|
| GET | /iclock/api/transactions/ | قائمة — صفِّ باستخدام ?start_time=، ?end_time=، ?emp_code= |
| GET | /iclock/api/transactions/{id}/ | تفصيل |
| DELETE | /iclock/api/transactions/{id}/ | حذف تسجيل حضور |
| GET | /iclock/api/transactions/export/ | تصدير CSV، بنفس مرشحات القائمة |
ما لا يغطيه هذا الغلاف
تحتوي واجهة BioTime الحقيقية أيضًا على نحو 100 نقطة نهاية للتقارير/الرواتب/سير العمل تحت
/att/api/، /staff/api/، /payroll/api/، /workflow/api/ — وهي مولّدات تقارير خاصة بواجهة
BioTime نفسها، وليست ما تسحبه تكاملات الموارد البشرية/الرواتب الخارجية عادةً. يغطي هذا الغلاف
بيانات الهوية والحضور الأساسية (وحدتا الموظفين والأجهزة) التي تستخدمها التكاملات الحقيقية فعليًا.
الأمان
كل نقطة نهاية مقيّدة بشكل صارم بالشركة المالكة لبيانات اعتماد الغلاف المستخدمة للمصادقة — لا يمكن أبدًا لرمز BioTime API الخاص بشركة ما قراءة بيانات شركة أخرى أو التأثير عليها، بغض النظر عن المعرّفات (IDs) المُمرَّرة.