نیوا اس‌ام‌اس
صفحه اصلی وضعیت سرویس پایگاه دانش
امکانات پنل
بانک شماره هدفمند ارسال پیامک انبوه
خدمات ویژه
عبور از بلک‌لیست (خدماتی) وب‌سرویس و API پیامک افزونه‌های سایت‌سازها
دسترسی سریع
تعرفه‌ها نمایندگی
ورود به پنل ثبت نام / خرید پنل
الگو و OTP
۴ دقیقه مطالعه

ارسال پیامک الگو (OTP) با جایگذاری متغیرها

برای ارسال کد تایید و پیامک‌های خدماتی، از الگو (Pattern) استفاده کنید.

الگو چیست؟

الگو یک پیام از پیش تاییدشده است که داخل آن متغیرهایی مانند {code} قرار می‌گیرد و هنگام ارسال، مقدار آن جایگزین می‌شود.

ساختار درخواست

  • sending_type: مقدار pattern
  • from_number: شماره ارسال‌کننده (E.164)
  • code: کد الگو
  • recipients: آرایه شماره گیرنده (فقط یک شماره مجاز است)
  • params: کلید/مقدارهای جایگذاری (نام کلیدها باید با متغیرهای الگو یکی باشد)

نمونه ارسال OTP

POST https://nivasms.com/v1/api/send
Authorization: YOUR_TOKEN
Content-Type: application/json

{
  "sending_type": "pattern",
  "from_number": "+983000505",
  "code": "YOUR_PATTERN_CODE",
  "recipients": ["+989120000000"],
  "params": { "code": "123456" }
}
پیشنهاد: برای امنیت، زمان انقضا و تعداد تلاش را در سمت سرور کنترل کنید.