Información general
Su aplicación se ejecuta en un iframe de espacio aislado sin acceso a las cookies, al backend o a la billetera del usuario de Elata. Cuando necesita algo de la plataforma, como una compra, datos guardados o consentimiento, envía unpostMessage al marco principal. Elata hace el trabajo con la sesión del usuario y responde.
El puente no expone las credenciales de la cuenta ni los tokens de sesión. La actividad pública, los registros comerciales y la información que ingresa un usuario están separados de este aislamiento.
Utilice los paquetes SDK
Para la mayoría de las funciones, existe un pequeño paquete que incluye los mensajes, los tiempos de espera y los errores:
El consentimiento, los conocimientos, las notificaciones, la navegación y los comentarios utilizan llamadas simples
postMessage . Están documentados a continuación y en sus propias páginas.
Reglas básicas
- Enviar a los padres. Publicar en
window.parent. Utilice el origen del host conocido como destino cuando esté disponible. Los clientes del SDK manejan su propio transporte. Los oyentes escritos a mano deben verificar la ventana de respuesta y, cuando se conozca, su origen; No asuma que todos los manejadores de puentes aplican controles idénticos. - Utilice un
requestId. Cuando se espera una respuesta, incluya unrequestIdúnico (de 8 a 128 caracteres;crypto.randomUUID()funciona) y compárelo en la respuesta. - No maneja respuesta. Fuera de Elata (por ejemplo en desarrollo local) nadie responde. Utilice un tiempo de espera y degrade con gracia. Los paquetes SDK hacen esto por usted.
- Elata es la fuente de la verdad. Los precios, la propiedad y el consentimiento siempre provienen de Elata, nunca de los valores que envía su aplicación.
Referencia del mensaje
Compras
Utilice
app-payments en lugar de enviarlos manualmente.
Estado de la aplicación
Una vez que
@elata-biosciences/app-state esté en npm, prefiérelo a enviarlos manualmente. Consulte Estado de la aplicación.
Métricas
app-metrics utiliza una configuración MessageChannel dedicada con un protocolo de enlace __elata_metrics_init , no mensajes de ventana individuales. Utilice siempre el paquete Métricas y puntuaciones.
Consentimiento y conocimientos
Consulte Consentimiento e información.
Notificaciones
Ver Notificaciones.
Navegación
Enviar al usuario a la página de reproducción de otra aplicación en Elata:slug debe ser un slug de la aplicación Elata: letras minúsculas, dígitos y guiones, hasta 64 caracteres. No hay respuesta.