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

ویرایش گروه زنگ

گروه را به‌طور کامل بازنویسی می‌کند.

PUThttps://api.irnoti.com/v1/voip/groups/{id}
scope: sms.send

پاسخ بدون بدنه (۲۰۴).

پارامترها

ناممحلنوعتوضیح
id *مسیرstringشناسهٔ گروه.
name *بدنهstringنام گروه (≤۸۰).
strategyبدنهstringروش زنگ؛ پیش‌فرض ring_all (همه هم‌زمان).
members *بدنهstring[]شماره‌ها یا sip:<شناسه حساب> (۱ تا ۲۰ عضو).
ringTimeoutSecبدنهintegerمهلت زنگ (۵ تا ۱۲۰ ثانیه، پیش‌فرض ۲۵).

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

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

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

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

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

curl -X PUT 'https://api.irnoti.com/v1/voip/groups/4' \
  -H "Authorization: Bearer $IRNOTI_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "پشتیبانی",
  "members": [
    "09121234567"
  ],
  "ringTimeoutSec": 30
}'
پاسخ نمونه200 OK
{}
ویرایش گروه زنگ — مستندات API | ایران ناتیفیکیشن