문서로 건너뛰기
API

규칙 순서 바꾸기

순서 전체를 한 번의 호출로. 규칙 목록은 순서가 있어야만 의미가 있기 때문입니다.

POSTapi.openemail.uk/rules/reorder

본인 키로 워크스페이스에 실제 호출을 실행합니다.

POST /rules/reorder

순서 전체를 한 번의 호출로. 규칙 목록은 순서가 있어야만 의미가 있기 때문입니다.

예제

rules:write가 필요합니다. 본문에 연결의 모든 규칙을, 평가되길 원하는 순서대로 지정합니다. 새 순서의 전체 목록을 반환합니다.

curl
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 규칙이 목록을 어디서 끊는지를 결정합니다.