Guía de consulta del Registration ID

Descripción general

regidSearchPath es una opción de configuración del SDK de Web Push que permite personalizar la ruta de acceso a la página de consulta del Registration ID. Cuando un usuario visita la ruta configurada, el SDK muestra un cuadro de verificación segura; tras introducir el Appkey correcto, el usuario puede ver el Registration ID del dispositivo actual.

PC:

Móvil:

Características principales

🔐 Verificación segura: La comprobación del Appkey garantiza que solo usuarios autorizados puedan ver el Registration ID
📋 Copia con un clic: Copiar rápidamente el Registration ID para pruebas y depuración
🎨 Interfaz clara: Cuadro de diálogo sencillo
⚙️ Configuración flexible: Ruta de activación personalizada

Configuración

regidSearchPath

Tipo: string
Por defecto: /engagelab/regid
Obligatorio: No
Descripción: Ruta que activa el cuadro de consulta del Registration ID

Uso

Escenario 1: Ruta por defecto

Si no se configura regidSearchPath, el SDK utiliza la ruta por defecto /engagelab/regid.

MTpushInterface.init({ appkey: 'your-appkey', user_str: 'user-identifier', });

              
              MTpushInterface.init({
  appkey: 'your-appkey',
  user_str: 'user-identifier',
});

Este bloque de código se muestra en una ventana flotante

Al visitar https://yourdomain.com/engagelab/regid se abrirá el cuadro de consulta.

Escenario 2: Ruta personalizada

Defina una ruta personalizada según la estructura de su aplicación.

MTpushInterface.init({ appkey: 'your-appkey', user_str: 'user-identifier', regidSearchPath: '/admin/push-debug' });

              
              MTpushInterface.init({
  appkey: 'your-appkey',
  user_str: 'user-identifier',
  regidSearchPath: '/admin/push-debug'
});

Este bloque de código se muestra en una ventana flotante

Al visitar https://yourdomain.com/admin/push-debug se abrirá el cuadro de consulta.

Ejemplos de coincidencia de rutas

Si configura regidSearchPath: '/admin/regid', el cuadro se activará para:

✅ 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

Notas

Cuándo aparece: El cuadro solo se muestra después de que el SDK se haya inicializado correctamente.
Formato de ruta: regidSearchPath es una ruta relativa (p. ej. /admin/regid). No incluya protocolo, dominio ni puerto.
Carga completa de página: La ruta se comprueba y el cuadro se muestra cuando el usuario abre la ruta en la barra de direcciones y la página se carga. No se activa en cambios de ruta del lado del cliente sin recarga completa.
Integración: La ruta debe corresponder a una página que incluya e inicialice el SDK; en caso contrario no aparecerá el cuadro de consulta.
Aplicaciones multipágina: En configuraciones multipágina, asegúrese de que la página HTML abierta para esa ruta incluya e inicialice el SDK.
Coincidencia: La coincidencia suele ser sensible a mayúsculas y comprueba si la ruta URL actual contiene la ruta configurada (véanse los ejemplos anteriores).