RuStore
الوصول إلى بطاقة تطبيق Android في RuStore وإلى معلمات مشروع push. في الإصدار الحالي لا يؤدي حفظ هذا النموذج بحد ذاته إلى تبديل قناة push الفعلية على الخادم.
افتح Integrations → إضافة تكامل → RuStore. للاتصال المثبّت مسبقًا استخدم إعداد.
التحضير
- ابحث عن project_id للتطبيق في RuStore Console ضمن قسم إشعارات push، وعن package name في بطاقة التطبيق أو في ردّ API لقائمة التطبيقات.
- في RuStore Console افتح التطبيق وقسم المفاتيح، وأنشئ مفتاحًا خاصًا واحفظ keyId الخاص به. وفق المثال الرسمي، وقّع keyId مع timestamp الحالي واستدعِ POST /public/auth/.
- انسخ JWE من body.jwe في الردّ إلى Public-Token. مدة صلاحيته 900 ثانية، لذا يجب أتمتة الحصول عليه أو تكليف المسؤول به مباشرة قبل الإعداد.
- في حقل «رمز push للخادم» الصق رمز مشروع push من إعدادات تطبيق RuStore. لا يبدّل هذا النموذج حاليًا تسليم push الفعلي على الخادم.
المعلمات
| الحقل | النوع | الغرض وقواعد التعبئة |
|---|---|---|
| معرّف المشروع (Project ID) | إعداد | project_id لمشروع إشعارات push من RuStore Console. حفظه هنا بحد ذاته لا يغيّر إرسال push الحالي. |
| اسم الحزمة | إعداد | applicationId لتطبيق Android في RuStore، مثل com.example.app؛ خذه من البطاقة أو من API قائمة التطبيقات. |
| رمز push للخادم | سر | الرمز السري للخادم الخاص بمشروع push من إعدادات التطبيق في RuStore Console. يتحقق هذا النموذج حاليًا من وجود الرمز لكنه لا يبدّل تسليم push الفعلي. |
| رمز الكتالوج (Public-Token) | سر | JWE من body.jwe في ردّ POST /public/auth/. مدة الصلاحية 900 ثانية؛ يُستخدم مع اسم الحزمة للتحقق من الكتالوج. |
الحفظ والتعديل
املأ المعلمات وانقر «حفظ». عند إعادة الفتح لا تُعرض الأسرار: مؤشر وجود السر ليس قيمته. الحقل الفارغ لسر موجود يحتفظ بالقيمة السابقة؛ والقيمة الجديدة تستبدلها. بعد التعديل تحقق من الاتصال من جديد.
نوع RuStore متاح في كتالوج التكاملات الكامل.
التحقق من النتيجة
- طابق packageName مع applicationId للتطبيق المطلوب.
- احصل على Public-Token حديث وتحقق من الوصول إلى بطاقة الكتالوج.
- لتأكيد push تحقق على حدة من إعدادات المرسِل على الخادم ورمز الجهاز والتسليم الاختباري المسموح به.
تعني الحالة «Configured» أن الإعدادات محفوظة. قيّم نتيجة فحص الاتصال ونتيجة العملية المستهدفة كلًّا على حدة. تتوفر تفاصيل الفحص في بطاقة الاتصال.
القيود والتبعيات
Public-Token الخاص بالكتالوج ورمز push للخادم سرّان مختلفان لغرضين مختلفين. تشير التعليمات المدمجة إلى أن مدة Public-Token هي 900 ثانية؛ فلا تستخدمه كرمز push دائم. يجب أن يتطابق المشروع مع اسم الحزمة.
عند عدم العمل
| العرض | ما يجب فحصه |
|---|---|
| لم يعد الكتالوج يجتاز التحقق | جدّد Public-Token قصير العمر وتحقق من packageName. |
| الإعدادات محفوظة لكن push لا يصل | لا يربط هذا النموذج الإرسال من الخادم تلقائيًا؛ تحقق من إعداد push على الخادم ومن تسجيل العميل. |
| يجتاز فحص الرمز لكن لا يوجد تسليم | التحقق من وجود رمز الخادم لا يؤكد الإرسال إلى الجهاز. |