إعادة ترتيب صناديق البريد

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

إعادة ترتيب صناديق البريد

يمكنك إعادة ترتيب كافة صناديق البريد ضمن مركز المساعدة اعتمادًا على قيمة المعامل sort لكل صندوق، وذلك بإرسال طلب من نوع POST إلى نقطة الاتصال inboxes/bulk-sort/ يتضمن معامل وحيد من نوع مصفوفة يدعى "inboxes" ويضم صناديق البريد التي تريد إعادة ترتيبها.

تحتوي المصفوفة inboxes على مجموعة عناصر objects، يمثل كل عنصر صندوق بريد معين، وتكتب وفق الصيغة التالية:

"inboxes": [
{"id": exampel_inbox_id, "sort": 0},
{"id": exampel_inbox_id, "sort": 1},
{"id": exampel_inbox_id, "sort": 2},
….
]

تكافئ هذه العملية إعادة ترتيب صناديق البريد التي تجريها ضمن الواجهة الرسومية بطريقة السحب والإفلات.

مثال

لنجرب الآن مثالًا عمليًّا لإعادة ترتيب صناديق البريد الستة في مركز مساعدة "المناسب":

curl -X POST --header 'Content-Type: application/json' --header 'Authorization: Bearer your_token' --data '{"inboxes": [
    {"id": 2139, "sort": 0},
    {"id": 2140, "sort": 1}, 
    {"id": 2219, "sort": 2},
    {"id": 2275, "sort": 3},
    {"id": 2281, "sort": 4},
    {"id": 2280, "sort": 5}
    ]}'  'https://al-munasib.zaetoon.com/api/agent/v1/inboxes/bulk-sort'