API REST en Mendix: ejemplo con la API de Chuck Norris

Introducción

Las API REST en Mendix son una herramienta potente que permite integrar aplicaciones de forma ágil y eficiente, facilitando el desarrollo de soluciones que satisfacen las necesidades del mercado actual. Imagina poder acceder a una infinidad de datos y servicios con solo unas pocas líneas de código; esa es la promesa de las API. En este artículo, vamos a explorar un ejemplo práctico utilizando la famosa API de Chuck Norris, que no solo ilustra la sencillez de uso de las API REST, sino que también añade un toque de humor al proceso de aprendizaje. Prepárate para descubrir cómo implementar esta integración y potenciar tus aplicaciones en Mendix, haciéndolas más dinámicas e interactivas.

API REST en Mendix: ejemplo con la API de Chuck Norris

Hola, ¿qué tal? En este artículo, vamos a aprender a utilizar una API REST dentro de una aplicación de Mendix. Para ello, utilizaremos la API pública de chistes de Chuck Norris y crearemos una aplicación sencilla e interactiva.

Estructura de la aplicación

Nuestra aplicación contará con:

• Una vista de datos para mostrar el texto del chiste.
• Un botón «New Joke» para buscar un chiste nuevo a través de la API.
• Lógica para almacenar temporalmente los chistes por usuario (utilizando una entidad no persistente).

Guía paso a paso para la integración con la API

1. Creación de la estructura JSON

1. Crea una carpeta llamada ExternalAPI.
2. Crea una nueva estructura JSON con los datos de la respuesta de la API. La respuesta de la API de Chuck Norris tiene esta estructura básica:

jsonCopiarEditar{
  "value": "Chuck Norris counted to infinity... Twice."
}

3. Tras pegar el ejemplo, Mendix generará automáticamente los atributos. Lo que nos interesa aquí es únicamente el campo value.

2. Creación de la asignación de importación

1. Haz clic con el botón derecho y crea una asignación de importación.
2. Selecciona la estructura JSON creada anteriormente.
3. Asigna el campo value para una entidad temporal (TempJoke) con un atributo Texto.

💡 Consejo: ¡Cambia los nombres automáticos para mantener tu proyecto organizado!

3. Creación de la entidad temporal

1. Crea la entidad Joke (no persistente).
2. Añade el atributo Texto (tipo String sin límite).
3. Crea una asociación con la cuenta del usuario (Account) para garantizar que cada usuario pueda ver su propio chiste.

4. Creación del microflujo DS_ShowJoke

Este microflujo se utilizará como fuente de datos para la pantalla.

Etapas:

• Realiza una llamada REST (GET) a la API de Chuck Norris.
• Utiliza Import Mapping para asignar la respuesta a un objeto temporal (Response).
• Comprueba si ya existe un objeto Joke para el usuario actual:
  • Si es así, actualiza el atributo Texto.
  • Si no es así, crea uno nuevo y asígnalo al usuario.
• Devuelve el objeto Joke.

Montar la pantalla

1. Añade una vista de datos con DS_ShowJoke como fuente de datos.
2. Dentro de él, añade una plantilla de texto y vincúlala al campo Texto.

Creación del botón «New Joke»

1. Añade un botón «New Joke».
2. Ásocialo a un microflujo llamado ACT_NewJoke.
3. Este microflujo solo:
   • Vuelve a ejecutar DS_ShowJoke.
   • Haz un Change Object con actualización en el cliente (sin modificar los atributos).

⚠️ ¡Esto garantiza que la pantalla se actualice con el nuevo contenido sin entrar en un bucle infinito!

Resultado final

Al iniciar la aplicación, verás que el primer chiste ya está cargado. Al hacer clic en «New Joke», se busca y se muestra un nuevo chiste.

Consejo técnico

La razón para utilizar un Change Object con refresh, aunque no se modifiquen los valores, es obligar a Mendix a actualizar la pantalla. Si no se detecta ningún «cambio», el front-end no entiende que debe volver a renderizar el contenido.

Conclusión

Utilizar las API REST en Mendix es sencillo y eficaz. Veamos este ejemplo:

• Hemos aprendido a utilizar una API pública.
• Utilizamos estructuras JSON y mapeo de importación.
• Colaboramos con entidades temporales.
• Hemos creado una experiencia interactiva y dinámica en el front-end.

Cómo funciona

Las API REST de Mendix te permiten conectarte e interactuar con servicios externos de forma sencilla y eficaz. El ejemplo de la API de Chuck Norris muestra cómo hacerlo en unos sencillos pasos:

1. Configuración de la API: En primer lugar, debes configurar la API en Mendix, indicando la URL y los parámetros necesarios para acceder a los datos deseados.
2. Creación de microflujos: A continuación, se crean microflujos que definen la lógica de cómo se solicitarán y procesarán los datos. Estos microflujos utilizan acciones específicas para llamar a la API.
3. Manipulación de respuestas: Tras la llamada, la API devuelve una respuesta en formato JSON. Puedes manipular esos datos dentro de Mendix para mostrarlos en la interfaz de usuario.
4. Visualización de los datos: Por último, los datos obtenidos se muestran en la aplicación, lo que permite a los usuarios ver, por ejemplo, un chiste de Chuck Norris directamente en su interfaz.

Con estos pasos, podrás integrar fácilmente API REST en Mendix y enriquecer tu aplicación con información externa.

Ventajas

Integración simplificada

Las API REST de Mendix permiten una integración fácil y rápida con servicios externos. Por ejemplo, al utilizar la API de Chuck Norris, puedes acceder a datos de chistes y frases de forma sencilla, sin necesidad de configuraciones complejas en el backend.

Desarrollo ágil

Con Mendix, puedes crear aplicaciones que utilizan API REST en cuestión de minutos. Esto significa que puedes probar e implementar nuevas funcionalidades rápidamente, como añadir una función de chistes aleatorios a tu aplicación, mejorando así la experiencia del usuario.

Escalabilidad

Las API REST están diseñadas para ser escalables. Esto significa que, a medida que tu aplicación crezca, podrás integrar fácilmente nuevos servicios o ampliar la capacidad de uso de la API, garantizando que tu aplicación siga siendo eficiente y responda con rapidez.

Personalización y flexibilidad

Al utilizar las API REST, tienes total libertad para personalizar la experiencia del usuario. Por ejemplo, puedes adaptar la forma en que se muestran los chistes de Chuck Norris en tu aplicación, lo que te permite crear una interfaz única que se ajuste a la identidad de tu marca.

Reducción de costes

Aprovechar las API existentes puede reducir significativamente los costes de desarrollo. En lugar de crear funcionalidades desde cero, puedes utilizar la API de Chuck Norris para ofrecer contenido divertido, ahorrando tiempo y recursos valiosos.

Casos de uso

Las API REST de Mendix ofrecen una amplia gama de aplicaciones prácticas. A continuación se muestran algunos ejemplos concretos:

• Aplicación de chistes: Un desarrollador puede integrar la API de Chuck Norris en una aplicación de entretenimiento, lo que permite a los usuarios recibir chistes aleatorios sobre Chuck Norris. Esto puede aumentar la participación y ofrecer una experiencia divertida al usuario.
• Plataforma de aprendizaje: En un entorno educativo, la API se puede utilizar para crear cuestionarios interactivos. Los alumnos pueden responder a preguntas basadas en los chistes, lo que fomenta el aprendizaje de una forma lúdica y dinámica.
• Aplicación de redes sociales: Una red social puede utilizar la API para generar contenido divertido, permitiendo a los usuarios compartir chistes en sus perfiles. Esto puede aumentar la interacción entre los usuarios y atraer a nuevos miembros a la plataforma.
• Bot de mensajería: Un bot en las aplicaciones de mensajería puede programarse para enviar chistes de Chuck Norris en respuesta a comandos específicos, lo que proporciona entretenimiento instantáneo a los usuarios en sus conversaciones.

Descubre el poder de Mendix

Eduardo Salerno

Eduardo Salerno es especialista en gestión de carteras y proyectos de TI, con una amplia experiencia en implementaciones de Planview y en transformación digital. En TWRT, lidera iniciativas que conectan la estrategia empresarial con la ejecución tecnológica.

Ver biografía completa