ارسال گروهی
ارسال یک متن واحد به فهرستی از شمارهها در یک درخواست.
POST
/api/v1/sms/send-bulk
یک متن را بهصورت همزمان برای چند گیرنده ارسال میکند. شمارههای نامعتبر و تکراری
پیش از ارسال حذف میشوند و در پاسخ، تعداد پذیرفتهشده و شناسهٔ دسته (batch_id) برمیگردد.
حداکثر ۱۰۰۰ شماره در هر درخواست.
پارامترها
| نام | نوع | الزامی | توضیح |
|---|---|---|---|
sender |
string | بله | شماره خط ارسالکننده. مثال: 5000XXXX |
recipients |
string[] | بله | آرایهای از شمارههای موبایل. مثال: ["09120000000","09120000001"] |
message |
string | بله | متن پیامک مشترک برای همهٔ گیرندگان. مثال: جشنواره فروش آغاز شد. |
نمونه کد
cURL
curl -X POST https://api.irnoti.com/v1/sms/send-bulk \
-H "Authorization: Bearer sk_live_xxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{
"sender": "5000XXXX",
"recipients": ["09120000000", "09120000001", "09120000002"],
"message": "جشنواره فروش آغاز شد."
}'
PHP
<?php
$payload = [
'sender' => '5000XXXX',
'recipients' => ['09120000000', '09120000001', '09120000002'],
'message' => 'جشنواره فروش آغاز شد.',
];
$ch = curl_init('https://api.irnoti.com/v1/sms/send-bulk');
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);
JavaScript
const res = await fetch('https://api.irnoti.com/v1/sms/send-bulk', {
method: 'POST',
headers: {
Authorization: 'Bearer sk_live_xxxxxxxxxxxxxxxx',
'Content-Type': 'application/json',
},
body: JSON.stringify({
sender: '5000XXXX',
recipients: ['09120000000', '09120000001', '09120000002'],
message: 'جشنواره فروش آغاز شد.',
}),
});
console.log(await res.json());