Przejdź do dokumentacji
API

Usuwanie kontaktu z grupy odbiorców

Kasuje jedną przynależność i nie rusza niczego innego. Kontakt zostaje w książce adresowej, zostaje w domyślnej grupie odbiorców i zostaje w każdej innej grupie, do której należał.

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

Uruchamia prawdziwe wywołanie na twojej przestrzeni roboczej, twoim własnym kluczem.

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

Kasuje jedną przynależność i nie rusza niczego innego. Kontakt zostaje w książce adresowej, zostaje w domyślnej grupie odbiorców i zostaje w każdej innej grupie, do której należał.

Przykład

Wymaga audiences:write. Zakoduj @ w adresie URL.

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

Kontakt, którego nie ma w tej grupie odbiorców, daje 404, więc literówka nie zgłosi usunięcia, do którego nigdy nie doszło.

Wbudowanej domyślnej grupy odbiorców nie da się przerzedzić. Takie wywołanie jest odrzucane z 409 audience_immutable, ponieważ trzyma ona każdy kontakt tak długo, jak długo jest on kontaktem. Gdy chcesz się pozbyć kontaktu, usuń kontakt.

Usunięcie ostatniego kontaktu zostawia grupę odbiorców na miejscu, pustą.