문서로 건너뛰기
API

연락처 차단

주소를 워크스페이스 차단 목록, 즉 `PATCH /settings`가 `blockedSenders`로 편집하는 목록에 올려 그때부터 그 주소에서 오는 메일을 거부합니다. 앱에서 연락처의 차단과 같습니다. 주소는 연락처가 아니어도 됩니다.

POSTapi.openemail.uk/contacts/{email}/block

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

POST /contacts/{email}/block

주소를 워크스페이스 차단 목록, 즉 PATCH /settingsblockedSenders로 편집하는 목록에 올려 그때부터 그 주소에서 오는 메일을 거부합니다. 앱에서 연락처의 차단과 같습니다. 주소는 연락처가 아니어도 됩니다.

예시

settings:write가 필요합니다. 연락처가 아니라 차단 목록에 쓰기 때문입니다. @는 URL 인코딩하세요.

curl
curl -X POST "$OE/contacts/offers%2Bweekly%40shop.example/block" -H "$AUTH"
응답
{  "object": "contact_block",  "email": "[email protected]",  "blocked": true,  "blockedBy": { "rule": "[email protected]", "list": "blockedSenders" },  "created": true}

플러스 태그는 버려지므로, [email protected]을 차단하면 [email protected]과 그 모든 태그가 차단됩니다.

이미 규칙이 주소를 차단하고 있으면, 도메인 전체 규칙을 포함해 아무것도 추가하지 않습니다. created는 false이고 blockedBy가 그 규칙을 알려 줍니다. 그래서 같은 호출을 다시 보내도 안전합니다.

글자나 숫자가 두 개 미만인 주소는 422 blocklist_entry_too_broad입니다.