문서로 건너뛰기
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로 돌아오며 나머지는 그대로 처리됩니다.

반복된 주소는 한 번으로 세며, 같은 호출을 다시 보내도 아무것도 바뀌지 않습니다. 되돌릴 수 없습니다.