تكاملات حضر
اجعل بيانات الحضور والمشاريع وسوق العمالة تعمل مع أنظمة شركتك.
التكاملات مخصصة للشركات المسجلة التي تريد مزامنة العمال، المشاريع، الحضور، طلبات العمالة، والطواقم المتاحة مع أنظمة الموارد البشرية، الرواتب، التخطيط، أو ERP. التفاصيل البرمجية متاحة عند الحاجة، لكنها ليست شرطاً لفهم القيمة.
للشركات المسجلة فقط
أي طلب API خاص يجب أن يستخدم مفتاحاً صادراً من لوحة الشركة داخل حضر.
محدود وآمن
حدود الذروة، عدم التخزين، ورؤوس الأمان مفعلة من أول إصدار.
مجاني أثناء الإطلاق
استخدام API الأساسي محدود الصلاحيات ومجاني الآن، مع مراجعة للتكاملات الكبيرة قبل التشغيل.
نموذج الربط الصحيح
تكاملات حضر لا تستخدم اسم المستخدم وكلمة المرور.
مسؤول الشركة يدخل حضر، ينشئ مفتاح API محدد الصلاحيات من لوحة الشركة، ثم يستخدم نظام ERP أو HR ذلك المفتاح فقط. يمكن إلغاء المفتاح أو تغييره بدون تغيير كلمة مرور أي موظف.
دليل العملاء والوكلاء
طريقة واحدة آمنة للأنظمة، CLI، ووكلاء الذكاء الاصطناعي.
العميل لا يعطي كلمة المرور لأي نظام خارجي. مسؤول الشركة ينشئ مفتاح API محدود الصلاحيات، ثم تستخدمه الأنظمة أو CLI أو MCP للوصول إلى بيانات الشركة فقط.
CLI للتقارير والتشغيل
CLI مناسب لفريق التقنية أو ERP عندما يريدون اختبار اتصال سريع، تصدير JSON، أو تشغيل فحص دوري من خادم آمن.
MCP للوكلاء
MCP يجعل أدوات مثل Codex وClaude والوكلاء الداخلية تقرأ بيانات حضر المصرح بها بدون كلمات مرور، وبنفس حدود API.
قاعدة الأمان
كل وكيل يجب أن يستخدم مفتاحاً منفصلاً وقابلاً للإلغاء. لا تستخدم مفتاحاً عاماً لكل الأنظمة، ولا تضع المفتاح في واجهة عامة.
خطوات الاعتماد
- 1سجل دخولك كمسؤول شركة وافتح صفحة API داخل لوحة الشركة.
- 2أنشئ مفتاحاً باسم واضح واختر أقل صلاحيات مطلوبة.
- 3ضع المفتاح في خادم الشركة أو بيئة الوكيل كمتغير HADHR_API_KEY.
- 4اختبر read-only أولاً: الشركة، المشاريع، العمال، الحضور، وطلبات السوق.
- 5راجع السجلات والحدود، ثم ألغ المفتاح أو دوّره عند انتهاء الحاجة.
أوامر البدء
export HADHR_API_KEY="hadhr_live_..." hadhr me hadhr workers --limit 25 hadhr mcp-config codex hadhr mcp-config claude hadhr mcp-stdio
تفاصيل المطورين
مسارات قراءة واضحة قبل فتح الكتابة.
الإصدار الأول يركز على القراءة الآمنة بمفاتيح محددة الصلاحيات حتى تستطيع الشركات اختبار التكاملات بدون تغيير بيانات الإنتاج بالخطأ.
| الطريقة | المسار | الاستخدام |
|---|---|---|
| GET | /api/v1/me | تأكيد الحساب والشركة والصلاحيات. |
| GET | /api/v1/projects | قراءة المشاريع والمواقع والنطاقات الجغرافية. |
| GET | /api/v1/workers | قراءة العمال المرتبطين بالشركة وحالة الهوية. |
| GET | /api/v1/attendance | قراءة سجلات الحضور حسب التاريخ والمشروع. |
| GET | /api/v1/marketplace/requests | قراءة طلبات سوق العمالة الخاصة بالشركة. |
| GET | /api/v1/marketplace/supply | قراءة طواقم العمالة المتاحة التي تعرضها الشركة. |
الأمان