پرش به مستندات
API

حذف گروهی مخاطبان

در یک فراخوانی تا ۲۰۰ نشانی را حذف می‌کند، هرکدام را همان‌طور که `DELETE /contacts/{email}` یکی را حذف می‌کند: مخاطب ذخیره‌شده با یادداشت‌ها، عکس و عضویت‌های گروهی‌اش می‌رود، و هر نشانی پنهان می‌شود تا ارسالی دوباره ثبتش نکند.

POSTapi.openemail.uk/contacts/batch-delete

فراخوانی واقعی را با کلید خودتان روی فضای کاری شما اجرا می‌کند.

POST /contacts/batch-delete

در یک فراخوانی تا ۲۰۰ نشانی را حذف می‌کند، هرکدام را همان‌طور که 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 برمی‌گردد و بقیه به هر حال انجام می‌شوند.

نشانی تکراری یک بار شمرده می‌شود، و فرستادن دوبارهٔ همان فراخوانی چیزی را تغییر نمی‌دهد. بازگشتی در کار نیست.