Einen Kontakt blockieren
Setzt die Adresse auf die Blockliste des Workspace, die `PATCH /settings` als `blockedSenders` bearbeitet, sodass Mails von ihr ab dann abgewiesen werden. Das ist Blockieren bei einem Kontakt in der App. Die Adresse muss kein Kontakt sein.
Führt den echten Aufruf gegen Ihren Workspace aus, mit Ihrem eigenen Schlüssel.
POST /contacts/{email}/block
Setzt die Adresse auf die Blockliste des Workspace, die PATCH /settings als blockedSenders bearbeitet, sodass Mails von ihr ab dann abgewiesen werden. Das ist Blockieren bei einem Kontakt in der App. Die Adresse muss kein Kontakt sein.
Beispiel
Erfordert settings:write, weil es die Blockliste schreibt und nicht den Kontakt. Das @ URL-kodieren.
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}Ein Plus-Tag fällt weg, das Blockieren von [email protected] blockiert also [email protected] und jeden Tag davon.
Blockiert schon eine Regel die Adresse, eine Regel für eine ganze Domain eingeschlossen, wird nichts hinzugefügt: created ist false und blockedBy nennt diese Regel. Denselben Aufruf erneut zu senden, ist deshalb sicher.
Eine Adresse mit weniger als zwei Buchstaben oder Ziffern ist ein 422 blocklist_entry_too_broad.