تخطَّ إلى المستندات
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 ويمضي الباقي على أي حال.

العنوان المكرر يُعدّ مرة واحدة، وإرسال الاستدعاء نفسه مجددًا لا يغيّر شيئًا. ولا تراجع عن ذلك.