Quickstarters

¿Cómo construir un backend para htmx?

35min

Introducción

En este tutorial, aprenderás a construir un backend completo para aplicaciones web htmx utilizando Back4app.

Recorreremos la integración de características esenciales de Back4app - como la gestión de bases de datos, funciones de Cloud Code, APIs REST y GraphQL, autenticación de usuarios, almacenamiento de archivos y consultas en tiempo real (Live Queries) - para crear un backend seguro, escalable y robusto que se comunique sin problemas con tu frontend htmx.

Usar htmx, una moderna biblioteca de JavaScript que aprovecha los atributos html para manejar interacciones del lado del cliente, puede mejorar drásticamente la experiencia del usuario mientras se enfoca en el renderizado del lado del servidor.

Al combinar htmx con los potentes frameworks del lado del servidor y motores de plantillas de Back4app, los desarrolladores pueden crear aplicaciones web de pila completa con facilidad y eficiencia.

Al final de este tutorial, habrás construido un backend adaptado para la integración de htmx, permitiendo operaciones de datos fluidas y mejorando la experiencia del lado del cliente con actualizaciones dinámicas de páginas html sin recargas completas.

Requisitos previos

Para completar este tutorial, necesitarás:

  • Una cuenta de Back4app y un nuevo proyecto de Back4app Comenzando con Back4app. Si no tienes una cuenta, puedes crear una gratis. Sigue la guía anterior para preparar tu proyecto.
  • Configuración básica de htmx Incluye la biblioteca htmx en tu página html usando:
  • Un entorno de desarrollo web Asegúrate de tener un servidor local configurado o utiliza frameworks del lado del servidor para servir tus plantillas html.
  • Familiaridad con HTML, CSS y JavaScript Documentación de htmx para más detalles sobre atributos html y desarrollo de aplicaciones web.

Asegúrate de tener todos estos requisitos previos en su lugar antes de comenzar. Tener tu proyecto de Back4app configurado y tu entorno local de htmx listo te ayudará a seguir más fácilmente.

Paso 1 – Configuración del Proyecto de Back4app

Crear un Nuevo Proyecto

El primer paso para construir tu backend de htmx en Back4app es crear un nuevo proyecto. Si aún no has creado uno, sigue estos pasos:

  1. Inicie sesión en su cuenta de Back4app.
  2. Haga clic en el botón “Nueva Aplicación” en su panel de Back4app.
  3. Dé un nombre a su aplicación (por ejemplo, “htmx-Backend-Tutorial”).
Document image


Una vez que se crea el proyecto, lo verás listado en tu panel de control de Back4app. Este proyecto será la base para todas las configuraciones de backend discutidas en este tutorial.

Conectar a través de la API REST

Back4app se basa en la Plataforma Parse para gestionar tus datos, proporcionar características en tiempo real, manejar la autenticación de usuarios y más.

Mientras que htmx es una biblioteca del lado del cliente, conectar tu frontend de htmx a Back4app implica hacer llamadas a la API REST directamente desde tu html y JavaScript.

Recupera tus Claves de Parse: En tu panel de Back4app, navega a la sección “Configuración de la Aplicación” o “Seguridad y Claves” de tu aplicación para encontrar tu ID de Aplicación, Clave de API REST, y la URL del Servidor Parse (a menudo en el formato https://parseapi.back4app.com).

Con estas claves, puedes usar htmx para llamar a tus puntos finales de backend y manipular tus plantillas html en consecuencia. Por ejemplo, podrías usar solicitudes fetch de JavaScript combinadas con atributos de htmx para interactuar con tus datos a través de llamadas REST.

Paso 2 – Configuración de la Base de Datos

Guardar y Consultar Datos

Con tu proyecto de Back4app configurado, ahora puedes comenzar a guardar y recuperar datos utilizando llamadas a la API REST, que puedes activar desde solicitudes htmx o JavaScript puro. La forma más sencilla de crear un registro es hacer una solicitud POST al servidor Parse:

Curl


De manera similar, puedes consultar datos:

Curl


También puedes usar consultas GraphQL según sea necesario para interactuar con tu base de datos desde el lado del cliente.

Diseño de Esquema y Tipos de Datos

Por defecto, Parse permite la creación de esquemas sobre la marcha, pero también puedes definir tus clases y tipos de datos en el panel de Back4app para tener más control.

  1. Navega a la sección “Base de Datos” en tu panel de Back4app.
  2. Crea una nueva clase (por ejemplo, “Todo”) y agrega columnas relevantes, como título (String) y estáCompletado (Boolean).



Back4app admite varios tipos de datos como String, Number, Boolean, Object, Date, File, Pointer, Array, Relation, GeoPoint, y Polygon. Utiliza estos para diseñar un esquema robusto para tu aplicación impulsada por htmx.

Back4app ofrece un Agente de IA que puede ayudarte a diseñar tu modelo de datos:

  1. Abre el Agente de IA desde tu Panel de Control de la App o en el menú.
  2. Describe tu modelo de datos en un lenguaje simple (por ejemplo, “Por favor, crea una nueva aplicación ToDo en back4app con un esquema de clase completo.”).
  3. Deja que el Agente de IA cree el Esquema por ti.



Usar el Agente de IA puede ahorrarte tiempo al configurar tu arquitectura de datos y asegurar la consistencia en tu aplicación.

Datos Relacionales

Si tienes datos relacionales, como vincular tareas a categorías, puedes usar Pointers o Relations en Parse a través de llamadas a la API REST. Por ejemplo, añadiendo un puntero:

JS


Cuando consultes, incluye datos de puntero según sea necesario:

JS


Consultas en Vivo

Para actualizaciones en tiempo real, Back4app proporciona Consultas en Vivo. Mientras que htmx se centra en la renderización del lado del servidor y atributos HTML, integrar actualizaciones en vivo puede mejorar significativamente la experiencia del usuario.

  1. Habilitar Consultas en Vivo en tu panel de Back4app bajo la Configuración del Servidor. Asegúrate de que “Consultas en Vivo” esté activado.
  2. Inicializar una Suscripción de Consulta en Vivo usando JavaScript junto con disparadores de htmx si es necesario:

(Nota: Las Consultas en Vivo generalmente requieren el SDK de Parse; sin embargo, aún pueden funcionar junto con htmx actualizando partes de la página cuando los datos cambian. Este ejemplo demuestra el concepto.)

JS


Esta suscripción puede luego activar solicitudes htmx o actualizar plantillas html dinámicamente para reflejar cambios en el lado del cliente.

Paso 3 – Aplicando Seguridad con ACLs y CLPs

Mecanismo de Seguridad de Back4app

Back4app toma la seguridad en serio al proporcionar Listas de Control de Acceso (ACLs) y Permisos a Nivel de Clase (CLPs). Estas características te permiten restringir quién puede leer o escribir datos a nivel de objeto o de clase, asegurando que solo los usuarios autorizados puedan modificar tus datos.

Listas de Control de Acceso (ACLs)

Una ACL se aplica a objetos individuales para determinar qué usuarios, roles o el público pueden realizar operaciones de lectura/escritura. Por ejemplo:

JS


Cuando guardas el objeto, tiene un ACL que impide que cualquier persona, excepto el usuario especificado, lo lea o lo modifique.

Permisos a Nivel de Clase (CLPs)

Los CLPs rigen los permisos predeterminados de toda una clase, como si la clase es legible o escribible públicamente, o si solo ciertos roles pueden acceder a ella.

  1. Ve a tu Panel de Control de Back4app, selecciona tu aplicación y abre la Base de Datos sección.
  2. Selecciona una clase (por ejemplo, “Todo”).
  3. Abre la pestaña de Permisos a Nivel de Clase.
  4. Configura tus predeterminados, como “Requiere Autenticación” para leer o escribir, o “Sin Acceso” para el público.

Estos permisos establecen la línea base, mientras que los ACLs ajustan los permisos para objetos individuales. Un modelo de seguridad robusto combina típicamente tanto CLPs (restricciones amplias) como ACLs (restricciones detalladas por objeto). Para más información, ve a Directrices de Seguridad de la Aplicación.

Paso 4 – Escribir y Desplegar Funciones en la Nube

El Código en la Nube es una característica del entorno de Parse Server que te permite ejecutar código JavaScript personalizado en el lado del servidor.

Al escribir Cloud Code, puedes extender tu backend de Back4app con lógica de negocio adicional, validaciones, disparadores e integraciones que se ejecutan de manera segura y eficiente en el Parse Server.

Cómo Funciona

Cuando escribes Cloud Code, normalmente colocas tus funciones de JavaScript, disparadores y cualquier módulo NPM requerido en un main.js archivo. Este archivo se despliega en tu proyecto de Back4app, que se ejecuta dentro del entorno del Parse Server.

JS


Despliega tu Cloud Code utilizando el CLI de Back4app o a través del Dashboard.

Llamando a Tu Función

Desde una interfaz mejorada con htmx, puedes llamar a tus funciones de Cloud Code utilizando fetch de JavaScript y actualizar partes de tu página html en consecuencia. Por ejemplo:

JS


Puedes integrar llamadas similares dentro de tus disparadores htmx y atributos html para crear comportamientos dinámicos y responsivos en el lado del cliente, mejorando la experiencia general del usuario.

Paso 5 – Configurando la Autenticación de Usuarios

Autenticación de Usuarios en Back4app

Back4app aprovecha la Clase Parse User como base para la autenticación. Por defecto, Parse maneja el hash de contraseñas, tokens de sesión y almacenamiento seguro.

En el contexto de una aplicación htmx, la autenticación de usuarios puede ser gestionada a través de llamadas REST iniciadas por envíos de formularios html o solicitudes fetch de JavaScript.

Configurando la Autenticación de Usuarios

Por ejemplo, para crear un nuevo usuario:

JS


De manera similar, para el inicio de sesión del usuario:

JS


Gestión de Sesiones

Después de un inicio de sesión exitoso, Parse crea un token de sesión que puedes almacenar y gestionar en tu aplicación htmx para solicitudes autenticadas posteriores.

Integración de Inicio de Sesión Social

Mientras htmx se centra en los atributos html y las interacciones del lado del servidor, integrar inicios de sesión sociales como Google o Facebook aún se puede lograr iniciando flujos de OAuth y manejando callbacks en el lado del servidor. Consulta Documentación de Inicio de Sesión Social para obtener orientación detallada.

Verificación de Correo Electrónico y Restablecimiento de Contraseña

Para habilitar la verificación de correo electrónico y el restablecimiento de contraseña:

  1. Navega a la Configuración de Correo Electrónico en tu panel de control de Back4app.
  2. Habilita la verificación de correo electrónico y configura las plantillas necesarias.
  3. Utiliza fetch en tus flujos de htmx para activar solicitudes de restablecimiento de contraseña según sea necesario.

Paso 6 – Manejo del Almacenamiento de Archivos

Subiendo y Recuperando Archivos

Parse incluye capacidades de almacenamiento de archivos que puedes utilizar a través de llamadas a la API REST desde tu aplicación htmx. Por ejemplo, para subir una imagen:

JS


Seguridad de Archivos

Controla quién puede subir y acceder a archivos configurando la configuración de seguridad en Back4app y estableciendo ACLs en los objetos de archivo según sea necesario.

Paso 7 – Programación de Tareas con Cloud Jobs

Cloud Jobs

Los Cloud Jobs en Back4app te permiten programar tareas rutinarias en tu backend, como limpiar datos antiguos o enviar correos electrónicos periódicos.

Estos trabajos se ejecutan del lado del servidor y se pueden integrar con tu flujo de trabajo htmx cuando sea necesario.

JS


Programa este trabajo a través del Panel de Control de Back4app en Configuración de la Aplicación > Configuración del Servidor > Trabajos en Segundo Plano.

Paso 8 – Integración de Webhooks

Webhooks permiten que tu aplicación Back4app envíe solicitudes HTTP a un servicio externo cada vez que ocurren ciertos eventos. Esto es poderoso para integrarse con sistemas de terceros como pasarelas de pago, herramientas de marketing por correo electrónico o plataformas de análisis.

  1. Navega a la configuración de Webhooks en tu panel de Back4app > Más > WebHooks y haz clic en Agregar Webhook.
  2. Configura un endpoint (por ejemplo, https://your-external-service.com/webhook-endpoint).
  3. Configura los triggers para especificar qué eventos en tus clases de Back4app o funciones de Cloud Code activarán el webhook.

Por ejemplo, para notificar a un canal de Slack cada vez que se crea un nuevo Todo:

  • Crea una aplicación de Slack que acepte webhooks entrantes.
  • Copia la URL del webhook de Slack.
  • En tu panel de Back4app, establece el endpoint a esa URL de Slack para el evento “Nuevo registro en la clase Todo.”
  • Opcionalmente, agrega encabezados HTTP personalizados o cargas útiles según sea necesario.

También puedes definir Webhooks en Cloud Code haciendo solicitudes HTTP personalizadas en los triggers.

Paso 9 – Explorando el Panel de Administración de Back4app

La Aplicación de Administración de Back4app es una interfaz de gestión basada en la web diseñada para usuarios no técnicos para realizar operaciones CRUD y manejar tareas rutinarias de datos sin escribir ningún código.

Proporciona una interfaz centrada en el modelo y fácil de usar que simplifica la administración de bases de datos, la gestión de datos personalizados y las operaciones a nivel empresarial.

Habilitando la Aplicación de Administración

Habilitar yendo a App Dashboard > Más > Aplicación de Administración y haciendo clic en el botón “Habilitar Aplicación de Administración.”

Crea un Primer Usuario Administrador (nombre de usuario/contraseña), lo que genera automáticamente un nuevo rol (B4aAdminUser) y clases (B4aSetting, B4aMenuItem y B4aCustomField) en el esquema de tu aplicación.

Elige un Subdominio para acceder a la interfaz de administración y completa la configuración.

Iniciar Sesión utilizando las credenciales de administrador que creaste para acceder a tu nuevo panel de control de la Aplicación de Administración.

Una vez habilitada, la Aplicación de Administración de Back4app facilita la visualización, edición o eliminación de registros de tu base de datos, sin requerir el uso directo del Panel de Control de Parse o código de backend.

Conclusión

Al seguir este tutorial completo sobre cómo construir un backend para htmx utilizando Back4app, has:

  • Creado un backend seguro adaptado para aplicaciones web htmx.
  • Configurado una base de datos con esquemas de clase, tipos de datos y relaciones.
  • Integrado consultas en tiempo real y considerado cómo las Consultas en Vivo pueden mejorar la experiencia del usuario en el lado del cliente.
  • Aplicado medidas de seguridad utilizando ACLs y CLPs para proteger y gestionar el acceso a los datos.
  • Implementado funciones de Cloud Code para ejecutar lógica de negocio personalizada en el lado del servidor.
  • Configurado autenticación de usuarios, almacenamiento de archivos, trabajos programados en la nube e integrado Webhooks.
  • Explorado el Panel de Administración de Back4app para una gestión eficiente de datos.

Con este robusto backend, ahora puedes aprovechar las capacidades de htmx para crear aplicaciones web dinámicas y modernas que combinan mejoras del lado del cliente con potentes frameworks del lado del servidor.

Este enfoque de pila completa mejora la experiencia general del usuario, proporcionando actualizaciones suaves de páginas html, renderizado eficiente del lado del servidor e integración fluida en tu pila tecnológica.

Próximos Pasos

  • Extender este backend para incorporar modelos de datos más complejos, motores de plantillas avanzados y lógica personalizada del lado del servidor.
  • Explorar la integración con frameworks del lado del servidor para crear una experiencia del lado del cliente más dinámica y receptiva.
  • Consultar la documentación oficial de Back4app para profundizar en seguridad avanzada, optimización de rendimiento y análisis.
  • Seguir aprendiendo sobre htmx y desarrollo web moderno para construir aplicaciones web amigables y receptivas que combinen lo mejor de las tecnologías del lado del cliente y del servidor.