ارسال پیامک پترن (OTP)

ارسال پیامک با الگوی از پیش تأییدشده و مقادیر متغیر.

POST /api/v1/pattern/send

پیامک پترن برای ارسال پیام‌های خدماتی مانند کد ورود، تأیید سفارش و اطلاع‌رسانی استفاده می‌شود و روی خطوط خدماتی حتی در سامانهٔ «۱۰۸۸» (مزاحم) هم تحویل داده می‌شود.

ابتدا الگو را از پنل کاربری ثبت و تأیید بگیرید؛ سپس pattern_code و مقادیر متغیرها را ارسال کنید. کلید‌های variables باید دقیقاً با نام متغیرهای الگو یکی باشند.

پارامترها

نام	نوع	الزامی	توضیح
`sender`	string	بله	خط خدماتی مجاز برای پترن. مثال: 3000XXXX
`recipient`	string	بله	شمارهٔ موبایل گیرنده. مثال: 09123456789
`pattern_code`	string	بله	کد الگوی تأییدشده. مثال: otp_login
`variables`	object	بله	نگاشت نام متغیر به مقدار. مثال: {"code":"48213"}

نمونه کد

cURL

curl -X POST https://api.irnoti.com/v1/pattern/send \
  -H "Authorization: Bearer sk_live_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "sender": "3000XXXX",
    "recipient": "09123456789",
    "pattern_code": "otp_login",
    "variables": { "code": "48213" }
  }'

PHP

<?php

$payload = [
    'sender' => '3000XXXX',
    'recipient' => '09123456789',
    'pattern_code' => 'otp_login',
    'variables' => ['code' => '48213'],
];

$ch = curl_init('https://api.irnoti.com/v1/pattern/send');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => json_encode($payload, JSON_UNESCAPED_UNICODE),
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer sk_live_xxxxxxxxxxxxxxxx',
        'Content-Type: application/json',
    ],
]);

print_r(json_decode(curl_exec($ch), true));
curl_close($ch);

Laravel

use Illuminate\Support\Facades\Http;

$messageId = Http::withToken('sk_live_xxxxxxxxxxxxxxxx')
    ->post('https://api.irnoti.com/v1/pattern/send', [
        'sender' => '3000XXXX',
        'recipient' => '09123456789',
        'pattern_code' => 'otp_login',
        'variables' => ['code' => (string) random_int(10000, 99999)],
    ])
    ->json('data.message_id');

JavaScript

const res = await fetch('https://api.irnoti.com/v1/pattern/send', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer sk_live_xxxxxxxxxxxxxxxx',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    sender: '3000XXXX',
    recipient: '09123456789',
    pattern_code: 'otp_login',
    variables: { code: '48213' },
  }),
});

console.log(await res.json());