← الرجوع للصفحة الرئيسية
🚧 Coming Q3 2026 · Early Access متاح

API Documentation

REST API كامل للـ developers اللي عايزين يبنوا integrations مخصصة مع Nidham.

📋 الحالة الحالية (تحديث 25 مايو 2026)

  • ✅ Internal API: Nidham بالكامل بيشتغل على REST API داخلي (Server Actions في Next.js 16). نفس الـ API بيخدم الـ dashboard + الـ mobile app.
  • ⏳ Public API + Documentation: في الـ roadmap لـ Q3 2026 (يوليو-سبتمبر). هتشمل: REST endpoints، OAuth 2.0 authentication، rate limiting، code samples (JavaScript + Python + PHP).
  • ✅ Early Access للـ Enterprise: لو عندك integration حرج محتاج تـ ship قبل Q3، تواصل معانا — بنفتح endpoints مخصصة للـ Enterprise customers.

اللي هيتغطّى في الـ API الكامل

GET/api/v1/employees

List + filter + paginate الموظفين

POST/api/v1/employees

إنشاء موظف جديد + ربطه بالـ payroll

GET/api/v1/payroll/runs

دورات المرتبات السابقة + تفاصيل كل دورة

POST/api/v1/payroll/calculate

حساب راتب موظف بالشهر + الضرايب + التأمينات

GET/api/v1/attendance

سجلات الحضور + GPS check-ins

POST/api/v1/leave-requests

إنشاء طلب إجازة + موافقة تلقائية

GET/api/v1/forms/insurance/{type}

توليد نموذج 1، 2، 6 PDF بالـ employee ID

POST/api/v1/webhooks

استقبال events من Nidham (payroll done، employee added، إلخ)

المواصفات التقنية

Protocol
REST + JSON
Authentication
OAuth 2.0 + API Keys
Rate Limiting
1000 req/hour (Free), 10k (Pro), unlimited (Enterprise)
Versioning
URL-based (/api/v1/, /api/v2/)
Response Time
< 200ms (p95)
Webhooks
HMAC signed payloads
SDKs
JavaScript / Python / PHP (Q4 2026)
Sandbox
api-sandbox.nidhamhr.com (Q3 2026)

عندك use case ما يقدر يستنّى Q3؟

Early Access متاح للـ Enterprise customers — بنفتح endpoints مخصصة في 2-3 أسابيع

💬 اطلب Early Access