APIs REST no Mendix: Exemplo com API do Chuck Norris

Introducción

As APIs REST no Mendix são uma ferramenta poderosa que permite a integração de aplicações de forma ágil e eficiente, facilitando o desenvolvimento de soluções que atendem à s necessidades do mercado moderno. Imagine poder acessar uma infinidade de dados e serviços com apenas algumas linhas de código; essa é a promessa das APIs. Neste artigo, vamos explorar um exemplo prático utilizando a famosa API do Chuck Norris, que não só ilustra a simplicidade de uso das APIs REST, mas também adiciona um toque de humor ao processo de aprendizado. Prepare-se para descobrir como implementar essa integração e potencializar suas aplicações no Mendix, tornando-as mais dinâmicas e interativas.

APIs REST no Mendix: Exemplo com API do Chuck Norris

Olá, tudo bem? Neste artigo, vamos aprender como consumir uma API REST dentro de uma aplicação Mendix. Para isso, utilizaremos a API pública de piadas do Chuck Norris, criando uma aplicação simples e interativa.

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. Após colar o exemplo, o Mendix vai gerar automaticamente os atributos. O que nos interessa aqui é apenas o 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

A razão para usar um Change Object com refresh, mesmo sem modificar valores, é forçar o Mendix a atualizar a tela. Se não houver nenhuma “mudança” detectada, o front-end não entende que deve re-renderizar o conteúdo.

Conclusión

Consumir APIs REST no Mendix é simples e poderoso. Com esse exemplo:

• 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

As APIs REST no Mendix permitem que você se conecte e interaja com serviços externos de forma simples e eficiente. O exemplo da API do Chuck Norris mostra como isso é feito em algumas etapas claras:

1. Configuração da API: Primeiro, você configura a API no Mendix, fornecendo a URL e os parâmetros necessários para acessar os dados desejados.
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. Manipulação de Respostas: Após a chamada, a API retorna uma resposta em formato JSON. Você pode manipular esses dados dentro do Mendix para exibi-los na interface do usuário.
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.

Com essas etapas, você pode integrar facilmente APIs REST no Mendix e enriquecer sua aplicação com informações externas.

Ventajas

Integración simplificada

As APIs REST no Mendix permitem uma integração fácil e rápida com serviços externos. Por exemplo, ao usar a API do Chuck Norris, você pode acessar dados de piadas e frases de forma simples, sem a necessidade de complexas configurações de backend.

Desarrollo ágil

Com Mendix, você pode criar aplicativos que consomem APIs REST em questão de minutos. Isso significa que você pode testar e implementar novas funcionalidades rapidamente, como adicionar um recurso de piadas aleatórias ao seu aplicativo, melhorando a experiência do usuário.

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

As APIs REST no Mendix oferecem uma ampla gama de aplicações práticas. Aqui estão alguns exemplos 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.

Descubra o poder do Mendix

Eduardo Salerno

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

Ver biografía completa