ahlan hamad

سجل التغييرات

الجدول الأول مولّد من openapi.yaml عند كل نشر للموقع، فهو يطابق العقد دائماً. السجل المؤرخ تحته مكتوب يدوياً. راجع أيضاً سياسة الإصدارات والإيقاف.

حالة الإصدارات

الإصدارالحالةنقاط النهاية المتاحة
v1.0متاح5 / 5
v1.1متاح2 / 2
v1.2متاح8 / 8
v1.3متاح1 / 1
v1.4متاح6 / 6

v1.0

v1.1

v1.2

v1.3

v1.4

السجل

طلبات الإجازة وأحداث الإجازة (leave:read)

إضافةv1.3

صلاحية جديدة leave:read. يعرض GET /v1/leave-requests طلبات الإجازة في الشركة (مع التصفية حسب status أو employee_id أو updated_since)، وتبلّغ خمسة أحداث ويب هوك جديدة عن كل تغيير: leave.requested وleave.approved وleave.rejected وleave.cancelled وleave.updated. يتطلب الاشتراك فيها leave:read إضافة إلى webhooks:manage، وتتوقف النقطة عن استقبالها إذا فقد المفتاح أو الاتصال المالك لها صلاحية leave:read. يحمل الطلب التواريخ وعدد الأيام والحالة ودور من قرّر فقط، ولا يحمل أبداً الأسباب أو المرفقات أو الأرصدة أو الأسماء، وتظهر الإجازة المرضية وإجازة الأمومة والأبوة والوفاة والحج والعدة والزواج بالقيمة leave_type: "personal". المفاتيح والاتصالات الحالية لا تحصل على الصلاحية تلقائياً: أنشئ مفتاحاً جديداً، أو اطلب من الشركة إعادة ربط تطبيقك.

البحث عن موظف بالبريد الإلكتروني أو الرقم الوظيفي

إضافةv1.0

يقبل GET /v1/employees معاملين اختياريين جديدين، email وemployee_code، للبحث بالمطابقة التامة. مطابقة البريد الإلكتروني لا تفرّق بين الأحرف الكبيرة والصغيرة، أما الرقم الوظيفي فيفرّق. تأتي النتيجة في صفحة واحدة مع next_cursor: null ولا تضم إلا موظفي هذه الشركة. استخدم أحدهما فقط في كل طلب، ولا تجمعه مع cursor. القائمة بدونهما لم تتغير.

لا مجاميع مالية لمسيّرات الرواتب التي تضم أقل من 3 موظفين

تغييرv1.0

اعتباراً من 2026-10-08، يعيد مسيّر الرواتب الذي يضم أقل من 3 موظفين totals: null والحقل الجديد totals_withheld: "below_min_headcount"، لأن مجاميعه ستكشف راتب شخص بعينه. تبقى الفترة والحالة والعملة والتواريخ وemployee_count كما هي. تنطبق القاعدة نفسها على GET /v1/payroll-runs وGET /v1/payroll-runs/{id} (حيث تكون components وjournal فارغتين) وعلى الويب هوك payroll_run.finalized وpayroll_run.paid وpayroll_run.corrected. المسيّرات التي تضم 3 موظفين أو أكثر لم تتغير. اعتبر totals قابلاً لأن يكون فارغاً وتحقق من totals_withheld.

نشر شروط واجهة برمجة الشركاء (الإصدار 2026-10-v1)

تغيير

نُشرت شروط واجهة برمجة الشركاء والمطوّرين على /developers/terms/، واتفاقية معالجة البيانات مع شروط معالجة البيانات للشركاء على /legal/dpa/، وقائمة المعالجين الفرعيين على /legal/subprocessors/. يتطلب الوصول الحي الآن الموافقة على الإصدار 2026-10-v1: يوافق عليه مستخدم العميل عند إنشاء مفتاح ah_live_، ويوافق عليه مالك المنظمة أو مديرها لكل تطبيق قبل اتصاله بشركة فعلية. ويظل وصول كل شركة خاضعاً للإطلاق التدريجي. ومهلة الإشعار بالإيقاف ١٢ شهراً للإصدار و٦ أشهر لنقطة النهاية أو الحقل.

رموز OAuth يمكنها إرسال الحضور وإدارة الويب هوك

تغيير

يمكن الآن منح تطبيق OAuth صلاحيتي attendance:write وwebhooks:manage. وبرمز الوصول تعمل POST /v1/attendance/events وكل نقاط /v1/webhooks كما تعمل بمفتاح API. الحركات ونقاط النهاية التي ينشئها الرمز تتبع اتصال التطبيق بالشركة: يتلقى أي تطبيق أو مفتاح آخر 404 عند طلبها، وإذا ألغت الشركة الاتصال (أو عُلّق التطبيق أو حُذف) تُعطَّل نقاط النهاية تلك مع disabled_reason: "connection_revoked"، وإعادة ربط التطبيق دون webhooks:manage تعطّلها مع disabled_reason: "scope_removed".

أدلة وسجل تغييرات ومجموعة Postman

توثيق

أدلة جديدة بالعربية والإنجليزية: بيئة التجربة والاختبار، ومفتاح API أم تطبيق OAuth، والويب هوك (مع أمثلة التحقق من التوقيع بلغات Node وPython وPHP)، والإصدارات والإيقاف، ومعاينة لتدفق OAuth المخطط. مجموعة Postman مولّدة من openapi.yaml متاحة على /developers/postman.json. ويُظهر المرجع الآن نقاط النهاية المتاحة.

مفاتيح API وبيئة تجربة ذاتية الخدمة وGET /v1/company

إضافةv1.0

مفاتيح 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 للويب هوك.