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

ساخت کد شماره‌گیری

کد و اعلان جدید.

POSThttps://api.irnoti.com/v1/voip/dial-actions
scope: sms.send

سقف ۲۰ در دقیقه.

پارامترها

ناممحلنوعتوضیح
code *بدنهstringکد شماره‌گیری (مثلاً *77).
name *بدنهstringنام (≤۸۰).
notify *بدنهobjectتعریف اعلان: کانال (webhook، sms یا email) و مقصد.
enabledبدنهbooleanفعال (پیش‌فرض true).

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

401unauthorizedکلید API نامعتبر یا منقضی است.
403insufficient_scopeکلید API دامنهٔ دسترسی لازم را ندارد.
400validation_errorورودی نامعتبر است (جزئیات در پاسخ).
409conflictاین کد قبلاً تعریف شده است.
429rate_limitedتعداد درخواست از سقف مجاز بیشتر شد؛ پس از زمان Retry-After دوباره تلاش کنید.

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

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

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

curl -X POST 'https://api.irnoti.com/v1/voip/dial-actions' \
  -H "Authorization: Bearer $IRNOTI_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "code": "*77",
  "name": "اعلان به CRM",
  "notify": {
    "url": "https://crm.example.com/hook",
    "channel": "webhook",
    "secretId": "3"
  },
  "enabled": true
}'
پاسخ نمونه200 OK
{
  "id": "5",
  "code": "*77"
}
ساخت کد شماره‌گیری — مستندات API | ایران ناتیفیکیشن