إعادة ترتيب القواعد
الترتيب كله في نداء واحد، لأن قائمة القواعد لا تعني شيئًا إلا بترتيبها.
ينفّذ الاستدعاء الحقيقي على مساحة عملك، بمفتاحك أنت.
POST /rules/reorder
الترتيب كله في نداء واحد، لأن قائمة القواعد لا تعني شيئًا إلا بترتيبها.
مثال
يتطلب rules:write. وجسم الطلب يسمّي كل قاعدة على الاتصال، بالترتيب الذي تريد تقييمها به. ويُعيد القائمة كاملة بترتيبها الجديد.
curl -X POST "$OE/rules/reorder" -H "$AUTH" -H "Content-Type: application/json" \ -d '{ "ruleIds": ["rul_7f3a1c94…", "rul_2b81de07…", "rul_c40a95f2…"] }'{ "object": "list", "data": [ { "object": "rule", "id": "rul_7f3a1c94…", "name": "Receipts to their own label", "position": 0 }, { "object": "rule", "id": "rul_2b81de07…", "name": "Newsletters after hours", "position": 1 }, { "object": "rule", "id": "rul_c40a95f2…", "name": "Anything from the old domain", "position": 2 } ], "hasMore": false, "nextCursor": null}القائمة الجزئية هي incomplete_order، وهو 422، ولا شيء يتحرك. فقبولها كان يعني اختراع مواضع للقواعد التي أغفلتها، وأين تحطّ تلك نسبةً إلى ما سمّيته كان سيصير تخميننا عن صندوق بريدك لا تعليمتك.
عديم الأثر عند التكرار بحكم البناء: فجسم الطلب يسمّي الترتيب كله، فإرساله مرتين ينتهي في المكان نفسه. آمن لإعادة المحاولة وآمن للتشغيل من نص برمجي لا يعرف الترتيب الحالي.
يُعاد كتابة كل موضع في عبارة واحدة داخل معاملة واحدة، فلا توجد لحظة تتشارك فيها قاعدتان موضعًا أو تكون فيها القائمة نصف مُعاد ترقيمها.
الترتيب ليس تجميليًا. فهو يقرر أي القاعدتين تسمّي المجلد الذي تنتهي إليه الرسالة، وأين تقطع قاعدة stopProcessing القائمة.