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

برآورد هزینهٔ ارسال از بانک

هزینهٔ ارسال به `count` شمارهٔ فیلترشده را بدون ارسال محاسبه می‌کند.

POSThttps://api.irnoti.com/v1/number-banks/quote
scope: sms.read

**فیلدهای پاسخ:** available تعداد شمارهٔ منطبق با فیلتر، parts تعداد بخش پیامک، smsPriceEach قیمت هر پیامک، estimatedSms جمع پیامک‌ها، fee کارمزد بانک و estimatedTotal مجموع (همه ریال و رشته).

پارامترها

ناممحلنوعتوضیح
bankId *بدنهstringشناسهٔ بانک.
count *بدنهintegerتعداد شمارهٔ هدف.
filtersبدنهobject{ operator?: mci|irancell|rightel|other, province?, city?, tag? }؛ همهٔ شروط با هم اعمال می‌شود.
lineId *بدنهstringخط فرستنده.
text *بدنهstringمتن پیام (حداکثر ۱۰۰۰ نویسه).

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

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

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

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

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

curl -X POST 'https://api.irnoti.com/v1/number-banks/quote' \
  -H "Authorization: Bearer $IRNOTI_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "text": "سلام، تخفیف ویژه!",
  "count": 1000,
  "bankId": "3",
  "lineId": "1",
  "filters": {
    "operator": "mci",
    "province": "تهران"
  }
}'
پاسخ نمونه200 OK
{
  "fee": "20000",
  "parts": 1,
  "available": 21000,
  "estimatedSms": "980000",
  "smsPriceEach": "980",
  "estimatedTotal": "1000000"
}
برآورد هزینهٔ ارسال از بانک — مستندات API | ایران ناتیفیکیشن