اربط كورتيكسا بأنظمتك: دليل المطورين
تتكامل الأنظمة الخارجية مع كورتيكسا في اتجاهين: تسحب وتكتب السجلات عبر REST API بمفتاح API أو رمز OAuth، ويدفع كورتيكسا التغييرات إليها عبر Webhooks موقّعة.
الاتجاهان
طريقتان للاتصال
crtk_live_crtk_oauth_المبدأ الأساسي
المفتاح أو الرمز يعمل بصلاحيات العضو الذي أنشأه، في حدود النطاقات المختارة. كل طلب يمر بفحصين: هل النطاق يسمح بهذا الإجراء؟ وهل مستوى العضو الحالي يسمح بهذا السجل؟ راجع نطاقات المفتاح وكيف تتقاطع مع الصلاحيات.
كل مقالات المطورين
/meما لا يصل إليه أي مفتاح
الأعضاء، والأدوار، والفوترة، وإعدادات المساحة، وبنية الوحدات والحقول، وقواعد التكرار، وإدارة المفاتيح والتطبيقات نفسها. هذه للبشر فقط.
المفتاح يعمل بصلاحيات منشئه. احفظه في خزنة أسرار على الخادم، ولا تضعه في شيفرة الواجهة الأمامية أو تطبيق جوال أو مستودع عام أو سجلات النظام.
مثال من الواقع
موقع الأكاديمية يجمع طلبات التسجيل ويريد إرسالها لكورتيكسا، واستقبال تحديث الحالة.
- أنشأ المطور مفتاحاً بنطاق كتابة على وحدة «العملاء المحتملون». راجع أنشئ مفتاح API وألغِه.
- الموقع يُنشئ سجلاً لكل طلب عبر API.
- اشترك المطور في
record.updatedليصله تغيير الحالة. راجع اشترك في Webhooks لتصلك تغييرات السجلات.
كل طلب يظهر في كورتيكسا خلال ثوانٍ، والموقع يعرض للطالب حالة طلبه.