ahlan hamad

بيئة التجربة والاختبار

تبني وتختبر تكاملك على شركة تجربة خاصة بك، فيها بيانات وهمية فقط. واجهة برمجة الشركاء غير متاحة للجميع بعد: اطلب الوصول إلى واجهة البرمجة وسنتواصل معك — والخطوات أدناه تُتَّبع بعد تفعيل وصولك.

إنشاء شركة التجربة بعد تفعيل وصولك

  1. سجّل الدخول إلى أهلاً حمد، أو أنشئ حساباً مجانياً.
  2. افتح التكاملات ← مفاتيح API واضغط إنشاء شركة تجربة (Create sandbox company).
  3. اختر الدولة: الكويت أو السعودية أو الإمارات أو قطر أو البحرين أو عُمان. العملة والمنطقة الزمنية وأيام نهاية الأسبوع وقواعد التأمينات تتبع الدولة التي تختارها.
  4. تصبح الرئيس التنفيذي للشركة (CEO) بالعضوية فقط، ولا تتغير شركتك الحالية. استخدم التبديل إلى شركة التجربة حين تريد العمل عليها.
  5. داخل شركة التجربة أنشئ مفتاح API واختر صلاحياته. يبدأ المفتاح بـ ah_test_ ويظهر مرة واحدة فقط، فانسخه فوراً.
curl https://actions.ahlanhamad.com/v1/company \
  -H "Authorization: Bearer ah_test_…"

لكل مستخدم شركة تجربة واحدة. إعادة ضبط شركة التجربة أو حذفها غير متاحة بعد.

ما الذي تحتويه شركة التجربة

رقم الموظفالمسمى الوظيفيالقسمالجنسيةemployment_type
SBX-001المدير العامManagementمواطن من بلد بيئة التجربةfull_time
SBX-002مدير الماليةFinanceمواطن من بلد بيئة التجربةfull_time
SBX-003موظفة موارد بشريةHuman Resourcesمواطن من بلد بيئة التجربةfull_time
SBX-004مدير المتجرRetailهنديfull_time
SBX-005أمينة صندوقRetailفلبينيfull_time
SBX-006أمين صندوقRetailمصريfull_time
SBX-007أمينة صندوقRetailهنديpart_time
SBX-008موظف مخزونRetailفلبينيfull_time
SBX-009سائقOperationsباكستانيfull_time
SBX-010محاسبةFinanceأردنيcontract

قواعد مفاتيح التجربة

ما يمكنك استدعاؤه اليوم

القائمة التالية مولّدة من openapi.yaml: العمليات المعلَّمة بأنها متاحة الآن، والعمليات المنشورة في العقد التي لم تُطلق بعد.

العمليةالإصدارالحالة
GET /v1/companyv1.0متاح
GET /v1/employeesv1.0متاح
POST /v1/employeesv1.4متاح
GET /v1/employees/{employee_id}v1.0متاح
PATCH /v1/employees/{employee_id}v1.4متاح
GET /v1/payroll-runsv1.0متاح
GET /v1/payroll-runs/{payroll_run_id}v1.0متاح
POST /v1/attendance/eventsv1.1متاح
GET /v1/attendancev1.1متاح
GET /v1/leave-requestsv1.3متاح
GET /v1/departmentsv1.4متاح
GET /v1/leave-balancesv1.4متاح
GET /v1/payslipsv1.4متاح
GET /v1/compliance-deadlinesv1.4متاح
GET /v1/webhooksv1.2متاح
POST /v1/webhooksv1.2متاح
GET /v1/webhooks/{webhook_id}v1.2متاح
PATCH /v1/webhooks/{webhook_id}v1.2متاح
DELETE /v1/webhooks/{webhook_id}v1.2متاح
POST /v1/webhooks/{webhook_id}/testv1.2متاح
GET /v1/webhooks/{webhook_id}/deliveriesv1.2متاح
POST /v1/webhooks/{webhook_id}/deliveries/{delivery_id}/redeliverv1.2متاح

تابع سجل التغييرات لمعرفة ما يُطلق. لتجربة كل نقاط النهاية بسرعة، استورد مجموعة Postman وضع مفتاح ah_test_ في المتغير apiKey.