API

連絡先をまとめて削除する

1 回の呼び出しで最大 200 のアドレスを削除します。それぞれ `DELETE /contacts/{email}` が 1 つを削除するのと同じで、保存済みの連絡先はメモ、写真、オーディエンスメンバーシップとともに消え、すべてのアドレスは非表示になるので、送信によって再び記録されることはありません。

POSTapi.openemail.uk/contacts/batch-delete

実際の呼び出しを、ご自身のキーで自分のワークスペースに対して実行します。

POST /contacts/batch-delete

1 回の呼び出しで最大 200 のアドレスを削除します。それぞれ DELETE /contacts/{email} が 1 つを削除するのと同じで、保存済みの連絡先はメモ、写真、オーディエンスメンバーシップとともに消え、すべてのアドレスは非表示になるので、送信によって再び記録されることはありません。

例

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 に入って返り、残りはそのまま処理されます。

重複したアドレスは 1 回として数え、同じ呼び出しをもう一度送っても何も変わりません。取り消しはできません。