مفاتيح API والتكاملات

يتولى ذلك تبويبان في الإعدادات (Settings): التكاملات (Integrations) لمفاتيح API ورسائل Webhook، والتطبيقات المتصلة (Connected apps) لتفويض التطبيقات.

إنشاء مفتاح API

افتح الإعدادات ← التكاملات، ثم انقر مفتاح API جديد (New API key). امنحه اسمًا لتتذكر الغرض منه، ثم انقر إنشاء (Create).

يظهر المفتاح مرة واحدة فقط، فانسخه قبل إغلاق النافذة. لا يمكن استرجاعه لاحقًا، ولن يعرض الجدول بعد ذلك إلا بادئته. إذا فقدته، فألغِه وأنشئ مفتاحًا جديدًا.

يعرض جدول المفاتيح الاسم، وبادئة المفتاح، وتاريخ الإنشاء، وآخر استخدام، والحالة. وعمود آخر استخدام مفيد جدًا لاكتشاف المفاتيح التي لم يعد أي شيء يستخدمها.

الإلغاء فوري ونهائي. انقر أيقونة سلة المهملات وأكّد. يتوقف كل ما يستخدم هذا المفتاح عن العمل فورًا، بما في ذلك الاتصالات المبنية عليه. ويبقى الصف في الجدول بعلامة ملغى (Revoked) للرجوع إليه في سجلاتك.

Webhooks

ترسل رسائل Webhook الأحداث إلى رابط URL تختاره. انقر إضافة نقطة استقبال (Add endpoint)، والصق العنوان، وحدد الأحداث التي تهمك. يمكنك اختيار أحداث بعينها أو جميعها دفعة واحدة.

يظهر سرّ التوقيع مرة واحدة عند إنشاء نقطة الاستقبال، تمامًا مثل مفتاح API. يستخدمه الخادم المستقبِل للتحقق من أن طلب POST الموقّع جاء فعلًا من حسابك.

تعرض كل نقطة استقبال حالتها: OK مع وقت آخر إرسال ناجح، أو أخطاء (Errors) مع وقت آخر فشل، أو ملاحظة بأنه لم تتم أي عملية إرسال بعد.

تُوقَف نقاط الاستقبال المتعثّرة تلقائيًا. فبعد سلسلة من محاولات الإرسال الفاشلة، تحصل نقطة الاستقبال على علامة «معطّلة تلقائيًا». أصلح الجهة المستقبِلة، ثم أعد تفعيلها بزر التحديث. ويمكنك أيضًا تبديل أي نقطة استقبال بين نشطة (Active) ومعطّلة (Disabled) بنفسك، أو حذفها.

يمكنك تلقي رسالة بريد إلكتروني عند تعطيل نقطة استقبال تلقائيًا. تجد زر التبديل الخاص بذلك في قسم الإشعارات والخصوصية (Notifications and privacy)، راجع إعدادات الحساب.

التطبيقات المتصلة

هذا هو التبويب الثاني. يعرض التطبيقات المفوَّضة على حسابك عبر موصِّل، إلى جانب العنوان الذي تلصقه في التطبيق لربطه.

يعرض كل اتصال اسم التطبيق، وتاريخ الربط، وآخر استخدام، ونطاق الوصول. ويُوصف النطاق بلغة بسيطة: قراءة حسابك، وإجراء تغييرات توافق عليها، والبقاء متصلًا دون تسجيل الدخول من جديد.

فصل التطبيق يسحب وصوله فورًا. أكّد العملية، فيُفصل التطبيق في الحال. ويمكنك ربطه من جديد لاحقًا. أما زر فصل الكل (Disconnect all) فيلغي جميع الاتصالات دفعة واحدة.

النشاط الأخير (Recent activity) سجل بأحدث ما قامت به التطبيقات المتصلة في حسابك، فترى ما نُفّذ فعلًا، لا ما سُمح به فقط.