Skip to main content
GET
الحصول على حالة التسليم
يُرجِع إدخالاً واحداً لكل مستلم أُرسل إليه الإشعار فعلياً، مع النتيجة الحقيقية التي أبلغت عنها APNs/FCM — وليست فقط حالة الإشعار الإجمالية. مفيد لمعرفة أي الأجهزة استلمته تحديداً، ولماذا فشل أي تسليم فردي.
راجع مقدمة الـ API لإعداد الرابط الأساسي ومفتاحك الخاص قبل إرسال الطلبات.

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

string
مطلوب
معرّف مشروعك من إعدادات المشروع في لوحة التحكم.
string
مطلوب
notificationId المُرجَع عند إرسال الإشعار.
string
بديل قديم لترويسة lerix-key، ولا يزال مقبولاً.

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

200 OK
string
ios أو android أو web أو macos أو windows. الجهاز المسجّل من منصة لا يستطيع Lerix التسليم إليها بعد (مثل Linux) يحتفظ بقيمته الخاصة هنا.
string
sent أو failed، النتيجة الحقيقية التي أبلغت عنها APNs/FCM لهذا المستلم.
string | null
سبب الفشل عندما تكون status بقيمة failed؛ null خلاف ذلك. يكون إما السبب الذي أرسله مزوّد الخدمة، أو أحد رموز Lerix التالية بين قوسين متبوعاً برسالة:قد تظهر في تسليمات Windows أيضاً رموز WNS المذكورة في حل مشكلات Windows.مثال: [PLATFORM_NOT_CONFIGURED] Apple keys not configured.
string | null
رمز الجهاز الذي استهدفه هذا التسليم. تكون القيمة null إذا أُزيل الرمز تلقائياً بعد أن أُبلِغ عنه كرمز غير صالح بشكل دائم — يُحتفَظ بسجلّ التسليم حتى بعد زوال رمزه.
مصفوفة فارغة تعني أنه لم تجرِ أي محاولة بعد — مثلاً، لا يزال الإشعار scheduled، أو أُلغي قبل حلول موعده. عند الفشل، تتبع الاستجابة الشكل الموثّق في رموز الأخطاء والنجاح.