Guide de consultation du Registration ID
Présentation
regidSearchPath est une option de configuration du SDK Web Push qui permet de personnaliser le chemin d’accès à la page de consultation du Registration ID. Lorsqu’un utilisateur visite le chemin configuré, le SDK affiche une boîte de dialogue de vérification sécurisée ; après avoir saisi le bon Appkey, l’utilisateur peut consulter le Registration ID de l’appareil actuel.
PC :

Mobile :

Fonctionnalités principales
- 🔐 Vérification sécurisée : La vérification de l’Appkey garantit que seuls les utilisateurs autorisés peuvent voir le Registration ID
- 📋 Copie en un clic : Copier rapidement le Registration ID pour les tests et le débogage
- 🎨 Interface claire : Boîte de dialogue simple
- ⚙️ Configuration flexible : Chemin de déclenchement personnalisable
Configuration
regidSearchPath
- Type :
string - Par défaut :
/engagelab/regid - Obligatoire : Non
- Description : Chemin qui déclenche la boîte de dialogue de consultation du Registration ID
Utilisation
Scénario 1 : Chemin par défaut
Si regidSearchPath n’est pas défini, le SDK utilise le chemin par défaut /engagelab/regid.
MTpushInterface.init({
appkey: 'your-appkey',
user_str: 'user-identifier',
});
En visitant https://yourdomain.com/engagelab/regid, la boîte de dialogue de consultation s’ouvre.
Scénario 2 : Chemin personnalisé
Définissez un chemin personnalisé en fonction de la structure de votre application.
MTpushInterface.init({
appkey: 'your-appkey',
user_str: 'user-identifier',
regidSearchPath: '/admin/push-debug'
});
En visitant https://yourdomain.com/admin/push-debug, la boîte de dialogue de consultation s’ouvre.
Exemples de correspondance de chemins
Si vous définissez regidSearchPath: '/admin/regid', la boîte de dialogue sera déclenchée pour :
✅ https://example.com/admin/regid
✅ https://example.com/dashboard/admin/regid
✅ https://example.com/admin/regid?debug=true
✅ https://example.com/#/admin/regid
✅ https://example.com/#/dashboard/admin/regid
Notes
- Moment d’affichage : La boîte de dialogue n’est affichée qu’après une initialisation réussie du SDK.
- Format du chemin :
regidSearchPathest un chemin relatif (ex./admin/regid). Ne pas inclure le protocole, le domaine ou le port. - Chargement complet de la page : Le chemin est vérifié et la boîte de dialogue s’affiche lorsque l’utilisateur ouvre le chemin dans la barre d’adresse et que la page se charge. Elle n’est pas déclenchée lors des changements de route côté client sans rechargement complet.
- Intégration : Le chemin doit correspondre à une page qui inclut et initialise le SDK ; sinon la boîte de dialogue de consultation n’apparaît pas.
- Applications multi-pages : En configuration multi-pages, assurez-vous que la page HTML ouverte pour ce chemin inclut et initialise le SDK.
- Correspondance : La correspondance est généralement sensible à la casse et vérifie si le chemin URL actuel contient le chemin configuré (voir les exemples ci-dessus).
