الحصول على حالة التسليم
الإشعارات
الحصول على حالة التسليم
اطّلع على نتيجة التسليم لكل مستلم لإشعار معيّن.
GET
الحصول على حالة التسليم
يُرجِع إدخالاً واحداً لكل مستلم أُرسل إليه الإشعار فعلياً، مع النتيجة
الحقيقية التي أبلغت عنها APNs/FCM — وليست فقط حالة الإشعار الإجمالية. مفيد
لمعرفة أي الأجهزة استلمته تحديداً، ولماذا فشل أي تسليم فردي.
مصفوفة فارغة تعني أنه لم تجرِ أي محاولة بعد — مثلاً، لا يزال الإشعار
راجع مقدمة الـ API لإعداد الرابط الأساسي ومفتاحك الخاص قبل إرسال الطلبات.
المعاملات (Parameters)
string
مطلوب
معرّف مشروعك من إعدادات المشروع في لوحة التحكم.
string
مطلوب
notificationId المُرجَع عند إرسال الإشعار.string
مطلوب
مفتاحك الخاص من إعدادات المشروع.
الاستجابة (Response)
200 OK
string
ios أو android.string
sent أو failed، النتيجة الحقيقية التي أبلغت عنها APNs/FCM لهذا
المستلم.string | null
سبب الفشل من مزوّد الخدمة عندما تكون
status بقيمة failed؛ null خلاف
ذلك.string | null
رمز الجهاز الذي استهدفه هذا التسليم. تكون القيمة
null إذا أُزيل الرمز
تلقائياً بعد أن أُبلِغ عنه كرمز غير صالح بشكل دائم — يُحتفَظ بسجلّ التسليم
حتى بعد زوال رمزه.scheduled، أو أُلغي قبل حلول موعده.
عند الفشل، تتبع الاستجابة الشكل الموثّق في رموز الأخطاء والنجاح.