واجهة API وWebhooks: اربط إدارة المشاريع بكل أنظمتك
لفرق تقنية المعلومات التي تقيّم النظام: واجهة REST موثقة تغطي بيانات المشاريع، وWebhooks للأحداث الفورية، ومصادقة OAuth 2.0 بنطاقات صلاحيات، وبيئة اختبار منفصلة. النظام يتكامل مع بنيتك، لا العكس.
نقاط الاتصال
الطلب
الاستجابة
ما تغطيه الواجهة البرمجية
الموارد الأساسية في النظام متاحة للقراءة والإنشاء والتحديث، حسب الصلاحيات.
/projectsالمشاريعالبيانات والحالة والصحة والإنجاز.
/tasksالمهامالإنشاء والإسناد والحالات والتبعيات.
/timesheetsالساعاتالمسجلة والمعتمدة، للرواتب والفوترة.
/budgetsالميزانياتالبنود والالتزامات والمصروفات.
/risksالمخاطر والمشكلاتالسجلات والتقييمات.
/deliverablesالمخرجاتالإصدارات وحالات القبول.
/usersالمستخدمون والفرقالعضويات والأدوار.
/reportsبيانات التقاريرلأدوات التحليل الخارجية.
Webhooks: أحداث فورية بدل الاستعلام المتكرر
أمثلة لأحداث يرسلها النظام إلى أنظمتكم عند وقوعها.
| الحدث | متى يُرسل | استخدام شائع |
|---|---|---|
project.approved | عند اعتماد مشروع جديد | فتح مركز تكلفة في ERP |
deliverable.accepted | عند قبول مخرج | إصدار فاتورة الدفعة |
timesheet.approved | عند اعتماد جدول زمني | ترحيل الساعات للرواتب |
task.overdue | عند تأخر مهمة | تنبيه في قناة Teams |
budget.threshold | عند تجاوز حد الميزانية | تنبيه للمالية |
user.deactivated | عند إيقاف مستخدم | مزامنة أنظمة الوصول |
أمان التكاملات
كل تكامل باب إلى بياناتكم، ويُحمى كما يُحمى المستخدم.
OAuth 2.0 ونطاقات الصلاحية
كل رمز وصول مقيد بما يحتاجه التكامل فقط.
تقييد عناوين IP
قبول الطلبات من خوادم التكامل المعتمدة فقط.
توقيع الـ Webhooks
للتحقق من أن الحدث صادر من النظام فعلًا.
حدود الطلبات
لحماية الأداء من الاستخدام المفرط.
بيئة اختبار منفصلة
للتطوير دون مساس ببيانات الإنتاج.
أسئلة شائعة عن الـ API
نعم، واجهة REST بصيغة JSON تغطي المشاريع والمهام والساعات والميزانيات والمخاطر والمستخدمين وغيرها، للقراءة والإنشاء والتحديث وفق الصلاحيات. التكاملات
عبر OAuth 2.0 أو رموز وصول مخصصة للتكاملات، بنطاقات صلاحيات محددة لكل رمز، مع إمكانية تقييد عناوين IP المسموح لها. الأمن
إشعارات يرسلها النظام إلى عنوان تحدده عند وقوع حدث، مثل إنشاء مشروع أو اعتماد مخرج أو تغيير حالة مهمة، فيتفاعل نظامك فورًا بدل الاستعلام المتكرر. الأتمتة
نعم، كل طلب يُنفذ بصلاحيات المستخدم أو التكامل الذي يملك الرمز، ويُسجل في سجل التدقيق. سجل التدقيق
نعم، بيئة اختبار منفصلة ببيانات تجريبية لتطوير التكاملات واختبارها قبل ربطها ببيئة الإنتاج. منهجية التنفيذ
نعم، حدود معقولة لحماية أداء النظام، تُضبط حسب نموذج التشغيل. وفي التشغيل على سيرفرات المنشأة تحددها المنشأة. On-Premise
نعم، عبر الـ API أو طبقة بيانات مخصصة للتقارير، لبناء تحليلات المنشأة الخاصة. التقارير
نعم، بالتوثيق والبيئة التجريبية، أو يتولاها فريقنا ضمن مشروع التنفيذ. التكاملات
جلسة تقنية مع فريقكم لتقييم التكامل
نستعرض التوثيق والبيئة التجريبية، ونناقش سيناريوهات الربط مع أنظمتكم.