ارسال پیامک تکی
ارسال یک پیامک به یک شماره از یک خط مشخص.
POST
/api/v1/sms/send
یک پیامک متنی از خط انتخابی شما به یک گیرنده ارسال میکند. در پاسخ، شناسهٔ ارسال
(message_id) برمیگردد که برای پیگیری وضعیت تحویل استفاده میشود.
پارامترها
| نام | نوع | الزامی | توضیح |
|---|---|---|---|
sender |
string | بله | شماره خط ارسالکننده (خط اختصاصی یا اشتراکی فعال روی حساب شما). مثال: 5000XXXX |
recipient |
string | بله | شمارهٔ موبایل گیرنده با فرمت ۰۹xxxxxxxxx یا +989xxxxxxxxx. مثال: 09123456789 |
message |
string | بله | متن پیامک. طول مجاز بر اساس تعداد کاراکتر و نوع (فارسی/انگلیسی) محاسبه میشود. مثال: سفارش شما ثبت شد. |
schedule_at |
string (ISO 8601) | خیر | در صورت ارسال، پیامک در زمان مشخصشده ارسال میشود. مثال: 2026-03-21T09:30:00+03:30 |
نمونه کد
cURL
curl -X POST https://api.irnoti.com/v1/sms/send \
-H "Authorization: Bearer sk_live_xxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{
"sender": "5000XXXX",
"recipient": "09123456789",
"message": "خوش آمدید، سفارش شما ثبت شد."
}'
PHP
<?php
$payload = [
'sender' => '5000XXXX',
'recipient' => '09123456789',
'message' => 'خوش آمدید، سفارش شما ثبت شد.',
];
$ch = curl_init('https://api.irnoti.com/v1/sms/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',
],
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);
echo $response['data']['message_id'] ?? $response['message'];
Laravel
use Illuminate\Support\Facades\Http;
$response = Http::withToken('sk_live_xxxxxxxxxxxxxxxx')
->acceptJson()
->post('https://api.irnoti.com/v1/sms/send', [
'sender' => '5000XXXX',
'recipient' => '09123456789',
'message' => 'خوش آمدید، سفارش شما ثبت شد.',
]);
$messageId = $response->json('data.message_id');
JavaScript
const res = await fetch('https://api.irnoti.com/v1/sms/send', {
method: 'POST',
headers: {
Authorization: 'Bearer sk_live_xxxxxxxxxxxxxxxx',
'Content-Type': 'application/json',
},
body: JSON.stringify({
sender: '5000XXXX',
recipient: '09123456789',
message: 'خوش آمدید، سفارش شما ثبت شد.',
}),
});
const { data } = await res.json();
console.log(data.message_id);
Python
import requests
response = requests.post(
"https://api.irnoti.com/v1/sms/send",
headers={"Authorization": "Bearer sk_live_xxxxxxxxxxxxxxxx"},
json={
"sender": "5000XXXX",
"recipient": "09123456789",
"message": "خوش آمدید، سفارش شما ثبت شد.",
},
)
print(response.json()["data"]["message_id"])
C#
using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization =
new AuthenticationHeaderValue("Bearer", "sk_live_xxxxxxxxxxxxxxxx");
var payload = new
{
sender = "5000XXXX",
recipient = "09123456789",
message = "خوش آمدید، سفارش شما ثبت شد."
};
var response = await client.PostAsJsonAsync(
"https://api.irnoti.com/v1/sms/send", payload);
Console.WriteLine(await response.Content.ReadAsStringAsync());
Java
var body = """
{"sender":"5000XXXX","recipient":"09123456789","message":"خوش آمدید"}
""";
var request = HttpRequest.newBuilder()
.uri(URI.create("https://api.irnoti.com/v1/sms/send"))
.header("Authorization", "Bearer sk_live_xxxxxxxxxxxxxxxx")
.header("Content-Type", "application/json")
.POST(HttpRequest.BodyPublishers.ofString(body))
.build();
var response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());