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

ثبت سفارش سرویس

سفارش را ثبت و هزینه را از کیف پول کسر می‌کند.

POSThttps://api.irnoti.com/v1/services/{product}
scope: sms.send

فیلدهای بدنه به محصول بستگی دارد: regional (province، city?، count، text، scheduledAt?)، targeted (فیلترهای مخاطب مثل gender، ageFrom، ageTo، province، operator، job + count، text)، peyamap (operator، areas[]، text)، smart / voice / international (recipients[] تا ۱۰٬۰۰۰ شماره + text) و messenger (channel، recipients[]، text). تعداد منطقه‌ای/هدفمند ۱۰۰ تا ۱٬۰۰۰٬۰۰۰. سقف ۳۰ سفارش در دقیقه.

پارامترها

ناممحلنوعتوضیح
product *مسیرstringنام محصول.
text *بدنهstringمتن پیام.
countبدنهintegerتعداد مخاطب (منطقه‌ای/هدفمند).
recipientsبدنهstring[]شماره‌ها (smart، voice، messenger، international).
scheduledAtبدنهstringزمان ارسال به‌صورت ISO 8601 (UTC).

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

402insufficient_balanceاعتبار کافی نیست.
403kyc_requiredاحراز هویت لازم است.

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

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

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

curl -X POST 'https://api.irnoti.com/v1/services/smart' \
  -H "Authorization: Bearer $IRNOTI_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "text": "سلام",
  "recipients": [
    "09121234567"
  ]
}'
پاسخ نمونه200 OK
{
  "id": "61",
  "status": "pending"
}
ثبت سفارش سرویس — مستندات API | ایران ناتیفیکیشن