IRNoti
ورودشروع رایگان
مستنداتv1 stable
دریافت کلید API

ارسال تضمین‌شده (SOS)

ارسال پیام حیاتی از مسیرهای پلتفرم با جایگزینی خودکار پرووایدر.

POST/sms/sos
scope: sms.send

برخلاف ارسال عادی که به پرووایدر خط شما وابسته است، پیام از مسیرهای فعال پلتفرم (به‌ترتیب اولویت) ارسال می‌شود و اگر یک پرووایدر خطا بدهد، خودکار پرووایدر بعدی امتحان می‌شود. فقط برای پیام‌های فوری و حداکثر ۲۰۰ گیرنده؛ با تعرفهٔ جدا (sms.sos) محاسبه می‌شود و اگر برای گروه کاربری شما تعرفهٔ SOS تعریف نشده باشد خطای ۴۲۲ می‌گیرید.

پارامترها

ناممحلنوعتوضیح
to *بدنهstring | string[]شماره(های) گیرنده؛ حداکثر ۲۰۰.
text *بدنهstringمتن پیام (حداکثر ۱۰۰۰ نویسه).
Idempotency-Keyهدرstringکلید یکتا (حداکثر ۱۰۰ نویسه). ارسال دوباره با همان کلید، پیام تکراری نمی‌سازد و نتیجه قبلی را برمی‌گرداند.

خطاهای خاص این endpoint

400validation_errorبیش از ۲۰۰ گیرنده یا ورودی نامعتبر.
402insufficient_balanceاعتبار کافی نیست.
409conflictدر حال حاضر هیچ مسیر ارسالی در دسترس نیست.
422no_priceبرای سرویس SOS تعرفه‌ای تعریف نشده است.

اجرای زنده (محیط تست)

این endpoint در محیط تست پشتیبانی نمی‌شود؛ با کلید واقعی از سرور خودتان صدا بزنید.

بعدی ←
ارسال پیامک
curl -X POST '/sms/sos' \
  -H "Authorization: Bearer $IRNOTI_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: alert-77' \
  -d '{
  "to": [
    "09121234567"
  ],
  "text": "هشدار: قطعی سرویس"
}'
پاسخ نمونه200 OK
{
  "batchId": "920",
  "count": 1,
  "totalPrice": "5000",
  "replayed": false
}
ارسال تضمین‌شده (SOS) — مستندات API | ایران ناتیفیکیشن