الجدول الأول مولّد من openapi.yaml عند كل نشر للموقع، فهو يطابق العقد دائماً. السجل المؤرخ تحته مكتوب يدوياً. راجع أيضاً سياسة الإصدارات والإيقاف.
v1.0GET /v1/company — The company this API key belongs toGET /v1/employees — List employeesGET /v1/employees/{employee_id} — Get one employeeGET /v1/payroll-runs — List closed payroll runsGET /v1/payroll-runs/{payroll_run_id} — Get a closed payroll run with its components and journalv1.1POST /v1/attendance/events — Push clock events (clock in/out, breaks)GET /v1/attendance — Read back daily attendancev1.2GET /v1/webhooks — List webhook endpoints registered by this keyPOST /v1/webhooks — Register a webhook endpointGET /v1/webhooks/{webhook_id} — Get a webhook endpointPATCH /v1/webhooks/{webhook_id} — Change URL, events, or re-enable an endpointDELETE /v1/webhooks/{webhook_id} — Delete a webhook endpointPOST /v1/webhooks/{webhook_id}/test — Send a `ping` event to the endpoint nowGET /v1/webhooks/{webhook_id}/deliveries — Recent delivery attempts for an endpoint (self-debugging)POST /v1/webhooks/{webhook_id}/deliveries/{delivery_id}/redeliver — Send one past event again nowemployee.createdemployee.updatedemployee.leftpayroll_run.finalizedpayroll_run.paidpayroll_run.correctedpayroll_run.deletedattendance.rejectedpingأدلة جديدة بالعربية والإنجليزية: بيئة التجربة والاختبار، ومفتاح API أم تطبيق OAuth، والويب هوك (مع أمثلة التحقق من التوقيع بلغات Node وPython وPHP)، والإصدارات والإيقاف، ومعاينة لتدفق OAuth المخطط. مجموعة Postman مولّدة من openapi.yaml متاحة على /developers/postman.json. ويُظهر المرجع الآن نقاط النهاية المتاحة.
GET /v1/companyمفاتيح API بصلاحيات محددة من التكاملات ← مفاتيح API: مفاتيح ah_test_ لشركات التجربة الآن، ومفاتيح ah_live_ بعد نشر شروط الـ API. ويستطيع أي مستخدم مسجّل إنشاء شركة تجربة ببيانات وهمية. GET /v1/company أول نقطة نهاية متاحة؛ كل استجابة تحمل X-Request-Id وترويسات حدّ الطلبات، والأخطاء بصيغة application/problem+json. وافتُتح موقع توثيق المطوّرين على /developers.
نُشر عقد الإصدار الأول (openapi.yaml، المسودة 1) ودليل البدء السريع قبل التنفيذ ليتمكن الشركاء من البناء بالتوازي: v1.0 للقراءة، وv1.1 للحضور، وv1.2 للويب هوك.