Přeřazení pravidel
Celé pořadí jedním voláním, protože seznam pravidel dává smysl jen seřazený.
Spustí skutečné volání proti vašemu pracovnímu prostoru, s vaším vlastním klíčem.
POST /rules/reorder
Celé pořadí jedním voláním, protože seznam pravidel dává smysl jen seřazený.
Příklad
Vyžaduje rules:write. Tělo pojmenuje KAŽDÉ pravidlo na spojení, v pořadí, v jakém je chcete vyhodnocovat. Vrací celý seznam v novém pořadí.
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}Neúplný seznam je incomplete_order, 422, a nic se nepřesune. Přijmout ho by znamenalo vymyslet pozice pro pravidla, která jste vynechali, a to, kde by dopadla vůči těm jmenovaným, by byl náš odhad ohledně vaší schránky, ne váš pokyn.
Idempotentní už svou konstrukcí: tělo pojmenuje celé pořadí, takže poslat ho dvakrát skončí na témže místě. Je bezpečné to opakovat i pouštět ze skriptu, který současné pořadí nezná.
Všechny pozice se přepíšou jedním příkazem uvnitř jedné transakce, takže neexistuje okamžik, kdy by dvě pravidla sdílela pozici nebo byl seznam přečíslovaný jen napůl.
Pořadí není kosmetika. Rozhoduje, které ze dvou pravidel pojmenuje složku, kde zpráva skončí, a kde pravidlo se stopProcessing seznam utne.