Блокировка контакта
Вносит адрес в список блокировки рабочего пространства, тот, что `PATCH /settings` редактирует как `blockedSenders`, чтобы письма с него с этого момента отклонялись. Это «Заблокировать» у контакта в приложении. Адрес не обязан быть контактом.
Выполняет настоящий запрос в вашем рабочем пространстве, с вашим собственным ключом.
POST /contacts/{email}/block
Вносит адрес в список блокировки рабочего пространства, тот, что PATCH /settings редактирует как blockedSenders, чтобы письма с него с этого момента отклонялись. Это «Заблокировать» у контакта в приложении. Адрес не обязан быть контактом.
Пример
Требуется settings:write, потому что запись идёт в список блокировки, а не в контакт. Кодируйте @ в URL.
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.