ارسال به شمارههای بانک
پیام را برای `count` شمارهٔ فیلترشده از بانک میفرستد؛ کارمزد بانک و هزینهٔ پیامک با هم کسر میشود.
POST
scope: sms.sendhttps://api.irnoti.com/v1/number-banks/sendاگر ارسال پس از کسر کارمزد ردّ شود، کارمزد بازگردانده میشود. گیرندگان فهرست مسدودی/لغو عضویت حذف میشوند. نیاز به احراز هویت کامل.
**فیلدهای پاسخ:** batchId، count، smsPrice و fee (ریال، رشته) و replayed.
پارامترها
| نام | محل | نوع | توضیح |
|---|---|---|---|
| bankId * | بدنه | string | شناسهٔ بانک. |
| count * | بدنه | integer | تعداد شمارهٔ هدف. |
| filters | بدنه | object | { operator?: mci|irancell|rightel|other, province?, city?, tag? }؛ همهٔ شروط با هم اعمال میشود. |
| lineId * | بدنه | string | خط فرستنده. |
| text * | بدنه | string | متن پیام. |
| Idempotency-Key | هدر | string | کلید یکتا (حداکثر ۱۰۰ نویسه). ارسال دوباره با همان کلید، کار تکراری نمیسازد و نتیجهٔ قبلی را برمیگرداند. |
خطاهای خاص این endpoint
| 401 | unauthorized | کلید API نامعتبر یا منقضی است. |
| 403 | insufficient_scope | کلید API دامنهٔ دسترسی لازم را ندارد. |
| 400 | validation_error | ورودی نامعتبر است (جزئیات در پاسخ). |
| 402 | insufficient_balance | اعتبار کافی نیست. |
| 404 | not_found | بانک پیدا نشد یا متعلق به شما نیست. |
اجرای زنده (محیط تست)
باز کردن در کنسول کامل ←این endpoint در محیط تست پشتیبانی نمیشود؛ برای اجرا، کلید واقعی را در حالت «اجرای واقعی» وارد کنید.