ارسال پترن (قالب)
ارسال پیام بر اساس یک قالب تأییدشده با جایگذاری پارامترها — مناسب کد تأیید و پیامهای تراکنشی.
POST
scope: sms.sendhttps://api.irnoti.com/v1/sms/patternابتدا قالب را در پنل («الگوهای پیام») بسازید و منتظر تأیید بمانید. متغیرها در متن به شکل {name} نوشته میشوند و باید همگی در params بیایند.
پارامترها
| نام | محل | نوع | توضیح |
|---|---|---|---|
| code * | بدنه | string | کد الگو که پس از ساخت قالب در پنل نمایش داده میشود. |
| to * | بدنه | string | شماره گیرنده (یک شماره). |
| params | بدنه | object | مقادیر متغیرهای قالب، مثلا {"code": "4821"}. |
| Idempotency-Key | هدر | string | کلید یکتا (حداکثر ۱۰۰ نویسه). ارسال دوباره با همان کلید، پیام تکراری نمیسازد و نتیجه قبلی را برمیگرداند. |
| sosFallback | بدنه | boolean | جایگزین SOS برای همین ارسال؛ اگر نیاید، تنظیم خود الگو (روشن/خاموش در پنل) اعمال میشود. پیام SOS با همان متن رندرشده میرود. |
خطاهای خاص این endpoint
| 400 | missing_params | یکی از متغیرهای قالب در params نیست. |
| 403 | الگو هنوز تأیید نشده است. | |
| 404 | الگو یافت نشد. |
اجرای زنده (محیط تست)
باز کردن در کنسول کامل ←با یک کلید آزمایشی (در پنل ← وبسرویس ← «کلید آزمایشی») این درخواست را همینجا اجرا کنید. پیام واقعی ارسال نمیشود و هزینهای کسر نمیشود.