Regels herordenen
De volledige volgorde in één aanroep, want een regellijst betekent alleen iets in volgorde.
Voert de echte aanroep uit op je workspace, met je eigen sleutel.
POST /rules/reorder
De volledige volgorde in één aanroep, want een regellijst betekent alleen iets in volgorde.
Voorbeeld
Vereist rules:write. De body noemt ELKE regel op de connectie, in de volgorde waarin je ze geëvalueerd wilt hebben. Geeft de volledige lijst in de nieuwe volgorde terug.
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}Een gedeeltelijke lijst is incomplete_order, een 422, en er beweegt niets. Zo'n lijst accepteren zou betekenen dat we posities verzinnen voor de regels die je weggelaten hebt, en waar die dan terechtkwamen ten opzichte van de regels die je wél noemde, zou onze gok over jouw mailbox zijn en niet jouw instructie.
Idempotent van opzet: de body noemt de hele volgorde, dus hem twee keer sturen komt op hetzelfde uit. Het is veilig om opnieuw te proberen en veilig om te draaien vanuit een script dat de huidige volgorde niet kent.
Elke positie wordt in één statement binnen één transactie herschreven, dus er is geen moment waarop twee regels dezelfde positie delen of de lijst half hernummerd is.
Volgorde is niet cosmetisch. Ze bepaalt welke van twee regels de map noemt waar een bericht in belandt, en waar een regel met stopProcessing de lijst afkapt.