Skip to main content
POST
إلغاء إرسال إشعار
يطلب من كل جهاز أكّد استلام إشعار إزالته من درج الإشعارات، باستخدام طلب صامت لاحق (silent push). صالح فقط للإشعارات التي حالتها sent — الإشعار scheduled لم يُسلَّم أصلاً (استخدم إلغاء إشعار مجدوَل بدلاً من ذلك)، والإشعارات failed/canceled/unsent لم يبقَ منها شيء على الجهاز لإزالته. يبقى الإشعار في سجلّك؛ تصبح حالته unsent. هذا يصل إلى الجهاز فقط — لا يحذف شيئاً من السجلّ أبداً.
راجع مقدمة الـ API لإعداد الرابط الأساسي ومفتاحك الخاص قبل إرسال الطلبات.
يتطلّب هذا أن يكون تطبيق المستلم يعمل بإصدار من الـ SDK يدعم إلغاء الإرسال (يحتاج إلى ربط معالج إزالة الإشعار داخل AppDelegate.swift على iOS). الأجهزة على إصدار تطبيق أقدم لا يمكن استرجاع إشعارها، بغضّ النظر عمّا تفعله نقطة النهاية هذه من جهة الخادم.

المعاملات (Parameters)

string
مطلوب
معرّف مشروعك من إعدادات المشروع في لوحة التحكم.
string
مطلوب
notificationId المُرجَع عند إرسال الإشعار.
string
مطلوب
مفتاحك الخاص من إعدادات المشروع.

الاستجابة (Response)

201 Created
عند الفشل، تتبع الاستجابة الشكل الموثّق في رموز الأخطاء والنجاح.