ایران ناتیفیکیشن

ارسال پیامک پروژه

ارسال از بستهٔ پیامک پروژه (نه کیف پول شخصی).

POSThttps://api.irnoti.com/v1/project-sms/send
scope: project.sms.send

همان موتور ارسال /sms است ولی هزینه و تاریخچه به پروژه تعلق دارد. حداکثر ۱۰۰۰ گیرنده در هر درخواست و ۱۶۰۰ نویسه متن. سقف ۶۰۰ درخواست در دقیقه. نیاز به احراز هویت کامل.

پارامترها

ناممحلنوعتوضیح
projectIdبدنهstringشناسهٔ پروژه. کلید پروژه به یک پروژه بسته است و نیازی به این فیلد ندارد؛ کلید شخصی و توکن پنل باید آن را بدهند.
lineIdبدنهstringخط فرستنده؛ اگر نیاید، خط پیش‌فرض پروژه.
to *بدنهstring[]شماره‌های گیرنده.
text *بدنهstringمتن پیام.
Idempotency-Keyهدرstringکلید یکتا (حداکثر ۱۰۰ نویسه). ارسال دوباره با همان کلید، کار تکراری نمی‌سازد و نتیجهٔ قبلی را برمی‌گرداند.

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

401unauthorizedکلید API نامعتبر یا منقضی است.
403insufficient_scopeکلید API دامنهٔ دسترسی لازم را ندارد.
400project_requiredکلید شخصی بدون projectId.
402insufficient_balanceاعتبار کافی نیست.

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

باز کردن در کنسول کامل ←

این endpoint در محیط تست پشتیبانی نمی‌شود؛ برای اجرا، کلید واقعی را در حالت «اجرای واقعی» وارد کنید.

curl -X POST 'https://api.irnoti.com/v1/project-sms/send' \
  -H "Authorization: Bearer $IRNOTI_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: prj-1' \
  -d '{
  "to": [
    "09121234567"
  ],
  "text": "گزارش روزانه آماده است"
}'
پاسخ نمونه200 OK
{
  "count": 1,
  "batchId": "77",
  "replayed": false,
  "totalPrice": "980"
}
ارسال پیامک پروژه — مستندات API | ایران ناتیفیکیشن