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

خروج چند مخاطب از گروه

چند مخاطب را یک‌جا از گروه بیرون می‌آورد.

POSThttps://api.irnoti.com/v1/phonebook/groups/{id}/members/remove
scope: phonebook.write

تا ۵۰۰ شناسه. پاسخ تعداد خارج‌شده‌ها را می‌دهد.

پارامترها

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

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

401unauthorizedکلید API نامعتبر یا منقضی است.
403insufficient_scopeکلید API دامنهٔ دسترسی لازم را ندارد.
404not_foundگروه پیدا نشد یا متعلق به شما نیست.

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

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

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

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