الاشتراك وإلغاء الاشتراك بإشعارات صندوق بريد

سنوضح في هذا المقال كيفية الاشتراك وإلغاء الاشتراك بإشعارات صندوق بريد معين في مركز المساعدة مع تطبيق الأمثلة على مركز مساعدة تجريبي باسم
"المناسب al-munasib" له النطاق الفرعي al-munasib.zaetoon.com.

الاشتراك بإشعارات صندوق بريد

يمكن للمستخدم الحالي الذي سَجَّل دخول login إلى مركز المساعدة ويملك صلاحية الوصول إلى صندوق بريد معين أن يشترك بإشعارات هذا الصندوق حتى تصله رسائل بريدية بكل جديد يخصه.

يتم ذلك بإرسال طلب من نوع POST إلى نقطة الاتصال inboxes/{inbox_id}/subscribe/ مع تمرير الرقم التعريفي لصندوق البريد "inbox_id" كمتغير مسار في عنوان URL للطلب، وتمرير رمز الوصول Access Token الخاص بالمستخدم ضمن ترويسة الطلب، علمًا أن رمز الوصول هو الرمز الذي تعيده الواجهة البرمجية للمستخدم عند نجاح عملية تسجيل الدخول login إلى مركز المساعدة..

مثال

يبين المثال التالي كيفية اشتراك المستخدم الحالي بصندوق البريد ذو الرقم "2281" العائد لمركز مساعدة "المناسب al-munasib":

curl -X POST --header 'Authorization: Bearer your_token' 'https://al-munasib.zaetoon.com/api/agent/v1/inboxes/2281/subscribe'

إلغاء الاشتراك بإشعارات صندوق بريد معين

يستطيع المستخدم بطريقة مشابهةإلغاء اشتراكه بإشعارات صندوق البريد بإرسال طلب من نوع DELETE إلى نقطة الاتصال inboxes/{inbox_id}/unsubscribe/ مع تمرير الرقم التعريفي لصندوق البريد "inbox_id" كمتغير مسار ضمن عنوان URL للطلب وتمرير رمز الوصول الخاص بالمستخدم في ترويسة الطلب

مثال

يوضح المثال التالي كيفية إلغاء اشتراك المستخدم الحالي بصندوق البريد ذو الرقم "2281" العائد لمركز مساعدة "المناسب al-munasib":

curl -X DELETE --header 'Authorization: Bearer your_token' 'https://al-munasib.zaetoon.com/api/agent/v1/inboxes/2281/unsubscribe'