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

ارسال‌های زمان‌بندی‌شده و تدریجی

دسته‌های زمان‌بندی‌شده یا تدریجی که هنوز تمام نشده‌اند.

GEThttps://api.irnoti.com/v1/sms/scheduled
scope: sms.read

برای هر دسته: شناسه، تعداد کل، هزینهٔ رزروشده (ریال، رشته)، وضعیت، زمان ارسال (scheduledAt)، و برای ارسال تدریجی chunkSize، intervalMinutes و زمان آزادسازی بعدی (nextReleaseAt). با batchId می‌توانید دسته را لغو، متوقف یا ادامه دهید.

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

401unauthorizedکلید API نامعتبر یا منقضی است.
403insufficient_scopeکلید API دامنهٔ دسترسی لازم را ندارد.

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

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

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

curl -X GET 'https://api.irnoti.com/v1/sms/scheduled' \
  -H "Authorization: Bearer $IRNOTI_KEY"
پاسخ نمونه200 OK
[
  {
    "id": "918",
    "total": 500,
    "status": "scheduled",
    "chunkSize": null,
    "createdAt": "2026-10-30T10:00:00.000Z",
    "totalPrice": "490000",
    "scheduledAt": "2026-11-01T08:00:00.000Z",
    "nextReleaseAt": null,
    "intervalMinutes": null
  }
]
ارسال‌های زمان‌بندی‌شده و تدریجی — مستندات API | ایران ناتیفیکیشن