Belgelere geç
API

Kişiyi engelleme

Adresi çalışma alanının engel listesine, `PATCH /settings` ile `blockedSenders` olarak düzenlenen listeye koyar, böylece ondan gelen posta o andan itibaren reddedilir. Bu, uygulamada bir kişideki Engelle'dir. Adresin kişi olması gerekmez.

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

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

POST /contacts/{email}/block

Adresi çalışma alanının engel listesine, PATCH /settings ile blockedSenders olarak düzenlenen listeye koyar, böylece ondan gelen posta o andan itibaren reddedilir. Bu, uygulamada bir kişideki Engelle'dir. Adresin kişi olması gerekmez.

Örnek

settings:write gerektirir, çünkü kişiyi değil engel listesini yazar. @ karakterini URL kodlamasıyla yazın.

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

Artı etiketi atılır, bu yüzden [email protected] engellemek [email protected] adresini ve onun her etiketini engeller.

Bir kural adresi zaten engelliyorsa, tüm alan adını kapsayan bir kural dahil, hiçbir şey eklenmez: created false olur ve blockedBy o kuralı belirtir. Bu yüzden aynı çağrıyı yeniden göndermek güvenlidir.

İkiden az harf ya da rakam içeren bir adres 422 blocklist_entry_too_broad olur.