ایران ناتیفیکیشن

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

چند مخاطب را از همهٔ گروه‌ها، ایمیل و دستگاه‌ها حذف می‌کند.

POSThttps://api.irnoti.com/v1/phonebook/contacts/delete
scope: phonebook.write

تا ۵۰۰ شناسه در هر درخواست؛ برگشت‌پذیر نیست.

پارامترها

ناممحلنوعتوضیح
contactIds *بدنهstring[]شناسهٔ مخاطبین.

خطاهای خاص این endpoint

401unauthorizedکلید API نامعتبر یا منقضی است.
403insufficient_scopeکلید API دامنهٔ دسترسی لازم را ندارد.

اجرای زنده (محیط تست)

باز کردن در کنسول کامل ←

این endpoint در محیط تست پشتیبانی نمی‌شود؛ برای اجرا، کلید واقعی را در حالت «اجرای واقعی» وارد کنید.

curl -X POST 'https://api.irnoti.com/v1/phonebook/contacts/delete' \
  -H "Authorization: Bearer $IRNOTI_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "contactIds": [
    "801",
    "802"
  ]
}'
پاسخ نمونه200 OK
{
  "deleted": 2
}
حذف گروهی مخاطبان — مستندات API | ایران ناتیفیکیشن