Zur Dokumentation springen
API

Einen Kontakt aus einer Audience entfernen

Entfernt eine einzelne Mitgliedschaft und lässt alles andere unberührt. Der Kontakt bleibt im Adressbuch, bleibt in der Standard-Audience und bleibt in jeder anderen Audience, in der er war.

DELETEapi.openemail.uk/audiences/{id}/contacts/{email}

Führt den echten Aufruf gegen Ihren Workspace aus, mit Ihrem eigenen Schlüssel.

DELETE /audiences/{id}/contacts/{email}

Entfernt eine einzelne Mitgliedschaft und lässt alles andere unberührt. Der Kontakt bleibt im Adressbuch, bleibt in der Standard-Audience und bleibt in jeder anderen Audience, in der er war.

Beispiel

Erfordert audiences:write. Das @ URL-kodieren.

curl
curl -X DELETE "$OE/audiences/aud_4c1b8e2a7d9f05c36b4e8a71/contacts/grace%40example.com" -H "$AUTH"
Antwort
{  "object": "audience_member",  "audienceId": "aud_4c1b8e2a7d9f05c36b4e8a71",  "email": "[email protected]",  "deleted": true}

Ein Kontakt, der nicht in dieser Audience ist, ergibt ein 404; ein Tippfehler kann also keine Entfernung melden, die nie stattgefunden hat.

Die eingebaute Standard-Audience lässt sich nicht ausdünnen. Ein solcher Aufruf wird mit 409 audience_immutable abgelehnt, denn sie enthält jeden Kontakt so lange, wie er ein Kontakt ist. Löschen Sie den Kontakt, wenn der Kontakt verschwinden soll.

Wird der letzte Kontakt entfernt, bleibt die Audience bestehen und ist leer.