Saltar para a documentação
API

Bloquear um contacto

Põe o endereço na lista de bloqueio do espaço de trabalho, a que `PATCH /settings` edita como `blockedSenders`, para que o correio dele seja recusado a partir daí. É o Bloquear num contacto na app. O endereço não tem de ser um contacto.

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

Executa a chamada real contra o seu espaço de trabalho, com a sua própria chave.

POST /contacts/{email}/block

Põe o endereço na lista de bloqueio do espaço de trabalho, a que PATCH /settings edita como blockedSenders, para que o correio dele seja recusado a partir daí. É o Bloquear num contacto na app. O endereço não tem de ser um contacto.

Exemplo

Requer settings:write, porque escreve a lista de bloqueio e não o contacto. Codifique o @ em URL.

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

Uma etiqueta com mais é descartada, por isso bloquear [email protected] bloqueia [email protected] e todas as suas etiquetas.

Quando uma regra já bloqueia o endereço, incluindo uma regra de domínio inteiro, nada é acrescentado: created é false e blockedBy indica essa regra. Por isso é seguro enviar de novo a mesma chamada.

Um endereço com menos de duas letras ou números é um 422 blocklist_entry_too_broad.