نظرة عامة على التكاملات
يرتبط exoCortex بالأنظمة التي تستخدمونها بالفعل: يفتح نظام إداري تذاكر عبر API، وتتحول تنبيهات المراقبة والأمان إلى تذاكر، وينشئ مزوّد الهوية لديكم المستخدمين، ويستضيف موقعكم الإلكتروني نموذج الدعم.
أي تكامل تحتاجون إليه
Section titled “أي تكامل تحتاجون إليه”| تريدون… | استخدموا | الدليل |
|---|---|---|
| فتح تذاكر ومتابعتها من أحد أنظمتكم | REST API v1 مع مفتاح API | مفاتيح API |
| تلقي حدث عند تغيّر تذكرة | Webhook صادرة | Webhook الصادرة |
| تحويل تنبيهات المراقبة أو DevOps أو الأمان إلى تذاكر | Webhook واردة وموصِّلات | Webhook الواردة |
| مزامنة التذاكر مع نظام ITSM آخر | تكاملات Integration Center | Webhook الواردة |
| وضع نموذج دعم على موقعكم الإلكتروني | Widget | Widget |
| إنشاء المستخدمين وتعطيلهم من مزوّد الهوية لديكم | SCIM 2.0 | التزويد عبر SCIM |
| استيراد البيانات من نظام قائم | Import Hub | Integration Hub والاستيراد |
للاطلاع على أمثلة الشيفرة والمرجع الخاص بكل نقطة نهاية (endpoint) راجعوا قسم المطورين.
عنوان الـ API
Section titled “عنوان الـ API”تُوجَّه جميع الاستدعاءات إلى https://exocortex-api.ai-exo-cortex.com. يعمل كل تكامل على مستأجر (tenant) واحد فقط: مستأجر المفتاح أو الرمز المميز (token) أو الموصِّل الذي تستخدمونه.
الأمان
Section titled “الأمان”- ترتبط كل بيانات اعتماد بمستأجر واحد ولا ترى بيانات المستأجرين الآخرين.
- تُعرض مفاتيح API وأسرار webhook ورموز SCIM مرة واحدة فقط، عند إنشائها: احفظوها في أداة لإدارة الأسرار.
- الأحداث التي يرسلها إليكم exoCortex موقّعة، ويجب أن تكون الأحداث التي ترسلونها أنتم موقّعة كذلك: يتضمن التوقيع طابعًا زمنيًا (timestamp) ويحمي أيضًا من الطلبات المكررة.
- تتطلب وظائف الإدارة (مفاتيح API، وwebhook، ورموز SCIM) مسؤولًا في exoCortex Core: لا يمكن إدارة مفاتيح أخرى باستخدام مفتاح API.
الاستقرار
Section titled “الاستقرار”الإصدار الحالي من API التكامل هو 1.1.0. داخل /api/v1 لا نجري إلا تعديلات متوافقة: يجب أن يتجاهل العميل الخاص بكم الحقول والأحداث ورموز الخطأ التي لا يعرفها. تبقى الوظيفة المُهمَلة (deprecated) فعّالة لمدة ستة أشهر على الأقل من تاريخ الإعلان. وتتوقف الوظائف المُهمَلة حاليًا عن العمل في 30 يونيو 2027:
| الوظيفة المُهمَلة | البديل |
|---|---|
مفاتيح API nh_… |
المفاتيح nhk.<keyid>.<secret> |
التوقيع X-NH-Signature في webhook الصادرة |
X-Exo-Signature مع X-Exo-Timestamp |
التوقيع X-NH-Connector-Signature في webhook الواردة |
X-Exo-Signature مع X-Exo-Timestamp |
الحقول event وtimestamp وsource في متن webhook |
type، created_at، data |