Developer Portal
بني فوق
نِظام API
نِظام عنده REST API كامل ومفتوح — اقدر تربط أي حاجة: الموظفين، المرتبات، الحضور، والتقارير. كل حاجة بتشتغل بـ API Keys مع Rate Limiting مدمج.
Quick Start
أول طلب API خلال دقيقة واحدة.
١. صادق على طلبك
curl -H "Authorization: Bearer YOUR_API_KEY" \
https://api.nidhamhr.com/api/v1/employees٢. الرد — JSON
{
"data": [
{
"id": "uuid",
"full_name": "أحمد محمد",
"employee_code": "EMP-001",
"department": "المبيعات",
"basic_salary": 5000
}
],
"meta": { "total": 1, "page": 1 }
}المزيد من الـ Endpoints
كل endpoints الموظفين والمرتبات متاحة عبر REST. راجع API Docs للتفاصيل الكاملة.
| Method | Path | Description |
|---|---|---|
| GET | /api/v1/employees | قائمة الموظفين |
| GET | /api/v1/employees/:id | بيانات موظف |
| POST | /api/v1/employees | إضافة موظف |
| PATCH | /api/v1/employees/:id | تحديث موظف |
| GET | /api/v1/payroll | قائمة دورات المرتبات |
| POST | /api/v1/payroll | إنشاء دورة مرتبات |
Webhooks — أحداث حية في نظامك
استقبل أحداث فورية في نظامك الداخلي أو Zapier أو Make كل ما يحصل حدث في نِظام — موظف جديد، دورة مرتبات، طلب إجازة. الـ JSON payload بيروح على endpoint انت تحدده.
employee.createdموظف جديد اتضاف
employee.updatedبيانات موظف اتغيرت
payroll.period.createdدورة مرتبات جديدة
payroll.period.closedدورة مرتبات اتنفذت
attendance.importedسجلات حضور جديدة
leave.request.updatedتغيير في حالة طلب إجازة
Webhook Payload Example
{
"event": "employee.created",
"timestamp": "2026-05-29T10:30:00Z",
"data": {
"id": "uuid",
"full_name": "أحمد محمد",
"employee_code": "EMP-042",
"company_id": "uuid"
}
}ملاحظة: الـ webhooks بتدعم توقيع الرسائل بـ HMAC-SHA256 للتحقق من المصدر.
جاهز تبدأ تبني؟
سجل مجاناً واحصل على API Key فوراً. بدون بطاقة ائتمان، بدون تعقيد.
Rate Limiting مدمجالتوثيق بـ Swaggerدعم CORS