حذف جهات الاتصال

DELETE https://app.alaaqat.com/api/contacts/delete-selected

تحذف هذه النقطة جهة اتصال واحدة أو أكثر في طلب واحد، وتُحذف ملاحظات كل جهة اتصال معها. يحتاج مفتاح واجهة التطبيق البرمجية إلى الإمكانية contact-delete.

{warning} الحذف نهائي، ولا يمكن استرجاع جهة الاتصال المحذوفة ولا ملاحظاتها.

ترويسة الطلب

{
    "Accept": "application/json",
    "Content-Type": "application/json"
}

محتوى الطلب

{
    selected_ids: string[]
}
الحقل مطلوب التحققات الوصف
selected_ids مطلوب مصفوفة من معرّفات جهات الاتصال قيمة _id لكل جهة اتصال تريد حذفها.
{
    "selected_ids": [
        "6650f1a2b3c4d5e6f7a8b901",
        "6650f1a2b3c4d5e6f7a8b902"
    ]
}

أرسل المعرّفات في الحقل selected_ids، فإن أرسلتها باسم آخر لن يُحذف شيء.

إذا لم يطابق أحد المعرّفات جهة اتصال في حسابك، يُتجاوز ذلك المعرّف وتُحذف البقية.

الإستجابة

200 OK

{
    "message": "Entity was deleted successfully.",
    "data": []
}

تبقى الاستجابة نفسها سواء طابقت جميع المعرّفات جهات اتصال أم تُجووز بعضها. للتأكد من النتيجة، اعرض قائمة جهات الاتصال مرة أخرى.