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

لغو سفارش

سفارشی را که هنوز اجرا نشده لغو و هزینه را برمی‌گرداند.

POSThttps://api.irnoti.com/v1/services/{product}/{id}/cancel
scope: sms.send

فقط سفارش‌های در انتظار قابل لغو هستند.

پارامترها

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

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

401unauthorizedکلید API نامعتبر یا منقضی است.
403insufficient_scopeکلید API دامنهٔ دسترسی لازم را ندارد.
404not_foundسفارش پیدا نشد یا متعلق به شما نیست.
409conflictسفارش دیگر قابل لغو نیست.

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

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

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

curl -X POST 'https://api.irnoti.com/v1/services/targeted/15/cancel' \
  -H "Authorization: Bearer $IRNOTI_KEY"
پاسخ نمونه200 OK
{
  "id": "15",
  "status": "cancelled",
  "refunded": "250000"
}
لغو سفارش — مستندات API | ایران ناتیفیکیشن