Перейти к документации
API

Массовое удаление контактов

Удаляет до 200 адресов за один вызов, каждый так же, как `DELETE /contacts/{email}` удаляет один: сохранённый контакт уходит с заметками, фото и членством в аудиториях, а каждый адрес скрывается, чтобы отправка не записала его снова.

POSTapi.openemail.uk/contacts/batch-delete

Выполняет настоящий запрос в вашем рабочем пространстве, с вашим собственным ключом.

POST /contacts/batch-delete

Удаляет до 200 адресов за один вызов, каждый так же, как DELETE /contacts/{email} удаляет один: сохранённый контакт уходит с заметками, фото и членством в аудиториях, а каждый адрес скрывается, чтобы отправка не записала его снова.

Пример

Требуется contacts:write.

curl
curl -X POST "$OE/contacts/batch-delete" -H "$AUTH" -H 'content-type: application/json' -d '{  "emails": ["[email protected]", "[email protected]", "not-an-address"]}'
Ответ
{  "object": "contact_batch_delete",  "deleted": 2,  "saved": 1,  "invalid": ["not-an-address"]}

deleted считает удалённые и скрытые адреса, сохранённые или встречавшиеся только в почте, а saved показывает, сколько из них были сохранёнными контактами. Запись, которая не является адресом, возвращается в invalid, а остальное всё равно проходит.

Повторяющийся адрес считается один раз, и повторная отправка того же вызова ничего не меняет. Отменить нельзя.