Belgelere geç
API

Kuralları yeniden sırala

Tüm sıralama tek çağrıda, çünkü bir kural listesi ancak sırasıyla anlam taşır.

POSTapi.openemail.uk/rules/reorder

Gerçek çağrıyı kendi anahtarınızla çalışma alanınıza karşı çalıştırır.

POST /rules/reorder

Tüm sıralama tek çağrıda, çünkü bir kural listesi ancak sırasıyla anlam taşır.

Örnek

rules:write gerektirir. Gövde, bağlantıdaki HER kuralı değerlendirilmelerini istediğiniz sırayla adlandırır. Listenin tamamını yeni sırasıyla döndürür.

curl
curl -X POST "$OE/rules/reorder" -H "$AUTH" -H "Content-Type: application/json" \  -d '{ "ruleIds": ["rul_7f3a1c94…", "rul_2b81de07…", "rul_c40a95f2…"] }'
Yanıt
{  "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}

Kısmi bir liste incomplete_order, bir 422'dir ve hiçbir şey yer değiştirmez. Kabul etmek, dışarıda bıraktığınız kurallar için konum uydurmak anlamına gelirdi ve bunların adlandırdıklarınıza göre nereye yerleşeceği sizin talimatınız değil, posta kutunuz hakkındaki bizim tahminimiz olurdu.

Yapısı gereği idempotenttir: gövde tüm sıralamayı adlandırır, dolayısıyla iki kez göndermek aynı sonuca varır. Yeniden denemek de, mevcut sıralamayı bilmeyen bir betikten çalıştırmak da güvenlidir.

Her konum tek bir işlem içinde tek bir ifadeyle yeniden yazılır; dolayısıyla iki kuralın aynı konumu paylaştığı ya da listenin yarı yarıya yeniden numaralandırıldığı bir an yoktur.

Sıralama kozmetik değildir. Bir mesajın hangi klasöre gideceğini iki kuraldan hangisinin belirleyeceğine ve bir stopProcessing kuralının listeyi nerede keseceğine karar verir.