المطورون
إنشاء مفاتيح API وعملاء OAuth بصلاحيات محدودة، وإعداد خطافات الويب وتتبع سجلات التسليم.
متاحة اعتبارًا من باقة البداية.
ما هذه الشاشة
توفر بوابة المطورين الأدوات البرمجية اللازمة لربط داوملى بالأنظمة الخارجية مثل أنظمة تخطيط الموارد (ERP)، أو برامج الرواتب، أو مسارات العمل المؤتمتة. تتيح لمدراء المؤسسة إنشاء مفاتيح API وعملاء OAuth وتحديد ما يقرؤه كل منها أو يكتبه بالضبط، وتسجيل روابط Webhooks المؤمنة بتوقيع HMAC، وإرسال أحداث تجريبية، ومتابعة سجلات وصول الإشعارات.
نظرة على الشاشة

- تبويب مفاتيح API يتضمن نموذج إنشاء بالاسم ومحدد الصلاحيات، وجدولاً يسرد المفاتيح مع الاسم، البادئة، الصلاحيات، أنشأه، تاريخ الإنشاء، آخر استخدام، الحالة، وزر إلغاء.
- تبويب عملاء OAuth يتيح لنظامك استبدال معرّف العميل وسره برموز وصول قصيرة العمر، فلا يُرسل السر مع كل طلب. يعرض جدوله اسم العميل ومعرّف العميل والصلاحيات وأنشأه والحالة وزر إلغاء.
- محدد الصلاحيات يجمع الصلاحيات في الموظفين والإجازات والحضور والرواتب، لكل منها قراءة أو كتابة. وتظهر قراءة الرواتب منفصلة تحت وصول حساس مع تحذير.
- تبويب Webhooks يتيح تسجيل روابط الاستدعاء مع سر التوقيع واختيار الأحداث مقسمة حسب المجال: الحضور، والإجازات، والموظفون، والرواتب، والورديات، والزيارات الميدانية.
- لوحات الويب هوك وزر التجربة تعرض الروابط المهيأة مع وسوم الأحداث، وخيارات التعديل والحذف، وزر إرسال اختبار.
- جدول سجل التسليم ينبثق أسفل كل رابط لمعاينة محاولات الإرسال السابقة، ورموز استجابة HTTP، والتوقيت، وحالة إعادة المحاولة. ويعرض زر عرض البيانات المرسلة نص JSON كما أُرسل بالضبط.
كيفية إنشاء مفتاح API
- انتقل إلى تبويب مفاتيح API.
- اكتب اسم المفتاح (مثل "ربط نظام الرواتب").
- من الصلاحيات حدّد ما يحتاجه الربط، ويجب اختيار صلاحية واحدة على الأقل. الأقسام والوظائف والفروع تتبع صلاحيات الموظفين.
- اضغط على إنشاء مفتاح API.
- انسخ المفتاح السري الكامل فورًا من النافذة المنبثقة واحفظه في مكان آمن (لن يتم عرضه مرة أخرى).
أنشئ لكل ربط مفتاحه الخاص بالصلاحيات التي يحتاجها فقط، لتتمكن من إلغاء مفتاح دون المساس بغيره.
كيفية إنشاء عميل OAuth
- افتح تبويب عملاء OAuth.
- اكتب اسم العميل (مثل "مزامنة الرواتب") وحدّد الصلاحيات.
- اضغط على إنشاء عميل OAuth.
- انسخ من النافذة المنبثقة معرّف العميل والسر. يظهر السر مرة واحدة فقط ولا يمكن عرضه مرة أخرى.
- يطلب نظامك رمز وصول من واجهة داوملى بمعرّف العميل وسره. مدة الرمز ساعة واحدة، فاطلب رمزًا جديدًا عند انتهائه. ويعرض دليل المطورين شكل الطلب.
اختيار الصلاحيات
- الكتابة لا تتضمن القراءة. حدّد الاثنتين إذا احتاجهما الربط. النظام الذي يرسل البصمات فقط يكفيه كتابة الحضور.
- كتابة الموظفين تتيح إنهاء خدمة موظف. إنهاء خدمة موظف عبر الواجهة يوقف أيضا دخوله إلى حسابه، فامنحها فقط للأنظمة التي تثق بها.
- قراءة الرواتب تكشف راتب كل موظف وقسيمته. امنحها فقط للأنظمة التي تثق بها في بيانات الأجور. ولا تظهر عبر الواجهة إلا مسيّرات الرواتب المعتمدة أو المدفوعة.
- المفاتيح التي أُنشئت قبل ظهور الصلاحيات تقرأ الموظفين والحضور فقط، وهو ما كانت تفعله دائمًا.
كيفية إضافة Webhook
- انتقل إلى تبويب Webhooks واضغط على + إضافة Webhook.
- أدخل رابط الاستدعاء Webhook URL (يجب أن يكون رابطًا آمنًا HTTPS).
- اختياريًا، اكتب سر التوقيع والوصف. إذا تركت السر فارغًا يولّده داوملى ويعرضه مرة واحدة بعد الحفظ، فانسخه وقتها لأنه لا يمكن عرضه مرة أخرى.
- حدد الأحداث التي ترغب في الاشتراك بها.
- اضغط على حفظ Webhook.
- اضغط على إرسال اختبار للتأكد من استجابة خادمك ومعاينة سجل التسليم.
ملاحظات وحدود
- متاح اعتبارًا من باقة المبتدئ (Starter) للواجهة وعملاء OAuth وخطافات الويب جميعًا. إذا نزلت الشركة عن Starter تتوقف طلبات الواجهة، ويُرفض إضافة خطاف ويب أو تعديله أو تجربته، وتُتجاهل أحداث الويب ولا تُحفظ في طابور. تبقى مفاتيحك وعملاؤك واشتراكاتك، وبعد الترقية تُرسل الأحداث الجديدة فقط.
- مخصص لمالكي المؤسسة ومدراء الحساب فقط.
- المفاتيح والعملاء ملك للشركة لا لمن أنشأها، فتظل تعمل حتى لو غادر. يوضح عمود أنشأه من أنشأ كل منها ليتمكن أي مدير من إلغائه.
- يسري الإلغاء أو خفض الباقة خلال نحو 60 ثانية.
- الحدود: 60 طلبًا في الدقيقة لكل مفتاح أو عميل، و300 طلب في الدقيقة للشركة كلها.
- لا توجد بيئة تجريبية (sandbox) ولا مفاتيح اختبار. جرّب الربط على شركة اختبار منفصلة.
- تتطلب كل عملية كتابة عبر الواجهة ترويسة
Idempotency-Keyحتى لا يُنشئ تكرار الطلب سجلًا مكررًا. - يحمل كل إرسال الترويسة
X-Dawmly-Signature(توقيع HMAC-SHA256 لنص الرسالة بسرّك). ويسرد دليل المطورين كل حدث وحقوله. - أحداث الرواتب تحمل إجمالي المسير لكل عملة فقط، ولا تحمل راتب أي موظف بعينه.
- الاشتراكات التي أُنشئت قبل أكتوبر 2026 بأسماء الأحداث القديمة تظل تعمل، وعند تعديل أحدها تظهر الأحداث المقابلة لها محددة.