واجهة 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 أو طبقة بيانات مخصصة للتقارير، لبناء تحليلات المنشأة الخاصة. التقارير

نعم، بالتوثيق والبيئة التجريبية، أو يتولاها فريقنا ضمن مشروع التنفيذ. التكاملات

جلسة تقنية مع فريقكم لتقييم التكامل

نستعرض التوثيق والبيئة التجريبية، ونناقش سيناريوهات الربط مع أنظمتكم.