APIs REST no Mendix: Exemplo com API do Chuck Norris

Introduction

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.

Estrutura da Aplicação

Nossa aplicação contará com:

• Um data view para exibir o texto da piada.
• Um botão “New Joke” para buscar uma nova piada via API.
• Lógica para persistir as piadas temporariamente por usuário (usando entidade não persistente).

Passo a Passo da Integração com API

1. Criando o JSON Structure

1. Crie uma pasta chamada ExternalAPI.
2. Crie um novo JSON Structure com os dados da resposta da API. A resposta da API do Chuck Norris tem essa estrutura 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. Criando o Import Mapping

1. Clique com o botão direito e crie um Import Mapping.
2. Selecione o JSON Structure criado anteriormente.
3. Mapeie o campo value para uma entidade temporária (TempJoke) com um atributo Texto.

💡 Dica: Renomeie os nomes automáticos para manter seu projeto organizado!

3. Criando a Entidade Temporária

1. Crie a entidade Joke (não persistente).
2. Adicione o atributo Texto (tipo String ilimitado).
3. Crie uma associação com o usuário (Account), para garantir que cada usuário tenha sua própria piada visível.

4. Criando o Microflow DS_ShowJoke

Este microflow será usado como data source para a tela.

Etapas:

• Faça uma chamada REST (GET) para a API do Chuck Norris.
• Use o Import Mapping para mapear a resposta em um objeto temporário (Response).
• Verifique se já existe um objeto Joke para o usuário atual:
  • Se sim, atualize o atributo Texto.
  • Se não, crie um novo e associe ao usuário.
• Retorne o objeto Joke.

Montando a Tela

1. Adicione um Data View com DS_ShowJoke como data source.
2. Dentro dele, adicione um Text Template e vincule ao campo Texto.

Criando o Botão “New Joke”

1. Adicione um botão “New Joke”.
2. Associe-o a um microflow chamado ACT_NewJoke.
3. Esse microflow apenas:
   • Executa novamente DS_ShowJoke.
   • Faz um Change Object com refresh em client (sem alterar atributos).

⚠️ Isso garante que a tela atualize com o novo conteúdo sem entrar em loop infinito!

Resultado Final

Ao carregar a aplicação, você verá a primeira piada já carregada. Ao clicar em New Joke, uma nova piada é buscada e exibida.

Dica Técnica

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.

Conclusion

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

• Aprendemos a consumir uma API pública.
• Usamos JSON Structures e Import Mapping.
• Integramos com entidades temporárias.
• Criamos uma experiência interativa e dinâmica no front-end.

How It Works

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. Criação de Microflows: Em seguida, você cria microflows que definem a lógica de como os dados serão solicitados e processados. Estes microflows utilizam ações específicas para chamar a 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. Exibição dos Dados: Por fim, os dados obtidos são apresentados na aplicação, permitindo que os usuários vejam, por exemplo, uma piada do Chuck Norris diretamente na sua interface.

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

Benefits

Integração 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.

Desenvolvimento à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.

Scalability

As APIs REST são projetadas para serem escaláveis. Isso significa que, à medida que sua aplicação cresce, você pode facilmente integrar novos serviços ou aumentar a capacidade de uso da API, garantindo que seu aplicativo permaneça eficiente e responsivo.

Customização e Flexibilidade

Utilizando APIs REST, você tem a liberdade de personalizar a experiência do usuário. Por exemplo, você pode adaptar a maneira como as piadas do Chuck Norris são exibidas em seu aplicativo, permitindo uma interface única que se alinha com a identidade da sua marca.

Cost Reduction

Aproveitar APIs existentes pode reduzir significativamente os custos de desenvolvimento. Em vez de criar funcionalidades do zero, você pode utilizar a API do Chuck Norris para oferecer conteúdo divertido, economizando tempo e recursos valiosos.

Use Cases

As APIs REST no Mendix oferecem uma ampla gama de aplicações práticas. Aqui estão alguns exemplos concretos:

• Aplicativo de Piadas: Um desenvolvedor pode integrar a API do Chuck Norris em um aplicativo de entretenimento, permitindo que os usuários recebam piadas aleatórias sobre Chuck Norris. Isso pode aumentar o engajamento e proporcionar uma experiência divertida ao usuário.
• Plataforma de Aprendizado: Em um ambiente educacional, a API pode ser usada para criar quizzes interativos. Os alunos podem responder a perguntas baseadas nas piadas, promovendo o aprendizado de forma lúdica e dinâmica.
• Aplicativo de Redes Sociais: Uma rede social pode utilizar a API para gerar conteúdo divertido, permitindo que os usuários compartilhem piadas em seus perfis. Isso pode aumentar a interação entre os usuários e atrair novos membros para a plataforma.
• Bot de Mensagens: Um bot em aplicativos de mensagens pode ser programado para enviar piadas do Chuck Norris em resposta a comandos específicos, proporcionando entretenimento instantâneo aos usuários em suas conversas.

Discover the power of Mendix

Eduardo Salerno

Eduardo Salerno is a specialist in IT portfolio and project management, with extensive experience in Planview implementations and digital transformation. At TWRT, he leads initiatives that connect business strategy with technological execution.

See Full Bio