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

استعلام فوری وضعیت تحویل

وضعیت نهایی پیام را همین حالا از اپراتور می‌پرسد.

POSThttps://api.irnoti.com/v1/sms/messages/{id}/check
scope: sms.read

پلتفرم وضعیت تحویل را خودکار و در پس‌زمینه هم بررسی می‌کند؛ این مسیر برای وقتی است که نتیجه را فوری می‌خواهید. سقف ۳۰ درخواست در دقیقه. پاسخ همان ساختار GET /sms/messages/{id} را دارد.

پارامترها

ناممحلنوعتوضیح
id *مسیرstringشناسهٔ پیام.

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

401unauthorizedکلید API نامعتبر یا منقضی است.
403insufficient_scopeکلید API دامنهٔ دسترسی لازم را ندارد.
404not_foundپیام پیدا نشد یا متعلق به شما نیست.
429rate_limitedتعداد درخواست از سقف مجاز بیشتر شد؛ پس از زمان Retry-After دوباره تلاش کنید.

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

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

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

curl -X POST 'https://api.irnoti.com/v1/sms/messages/5521/check' \
  -H "Authorization: Bearer $IRNOTI_KEY"
پاسخ نمونه200 OK
{
  "id": "5521",
  "status": "delivered",
  "deliveredAt": "2026-10-30T10:20:03.000Z"
}
استعلام فوری وضعیت تحویل — مستندات API | ایران ناتیفیکیشن