As APIs se tornaram um componente crítico das aplicações web e móveis modernas. Elas permitem que diferentes sistemas de software se comuniquem e compartilhem dados de forma eficiente. No entanto, testar essas APIs pode ser uma tarefa desafiadora. É aí que ferramentas como Postman e APIdog entram em cena.
Este artigo tem como objetivo guiá-lo pelo processo de adicionar variáveis ao corpo JSON no Postman e no APIdog. Esse recurso poderoso pode tornar seu processo de teste mais dinâmico e eficiente.
O que é Postman?
Primeiro as coisas, vamos falar sobre o Postman. Postman é uma ferramenta popular usada por desenvolvedores e testadores para desenvolvimento e testes de API. Ele fornece uma interface amigável para enviar solicitações HTTP e visualizar respostas. Mas isso não é tudo! O Postman também oferece recursos avançados como variáveis de ambiente, scripts de pré-solicitação e scripts de teste, que vamos explorar neste post.

O que são variáveis?
No contexto de testes de API, variáveis são espaços reservados para dados que podem mudar. Elas são usadas para armazenar e transferir dados entre diferentes solicitações ou partes de uma solicitação. As variáveis podem conter vários tipos de dados, como strings, números, booleanos ou até mesmo objetos complexos e arrays.
As variáveis desempenham um papel crucial nos testes de API, aumentando a eficiência, manutenibilidade e robustez dos seus testes. Elas são fundamentais para qualquer ferramenta de teste de API, incluindo Postman e APIdog.

Por que usar variáveis no corpo JSON?
Usar variáveis no corpo JSON das solicitações de API tem várias vantagens:
- Conteúdo Dinâmico: As variáveis permitem que você insira conteúdo dinâmico em suas solicitações. Isso é particularmente útil quando o valor exato necessário no corpo da solicitação não é conhecido com antecedência ou muda com frequência.
- Teste Dirigido por Dados: As variáveis possibilitam testes dirigidos por dados. Você pode definir um conjunto de valores para uma variável e então executar o mesmo teste várias vezes, cada vez com um valor diferente do conjunto.
- Dados Específicos do Ambiente: Se você tem diferentes ambientes (como desenvolvimento, homologação, produção), as variáveis podem ser usadas para alternar entre diferentes conjuntos de dados sem mudar o corpo da solicitação em si.
- Reduzindo Repetição: Se um valor é usado em vários lugares dentro de uma solicitação, uma variável pode ser usada para representar esse valor. Isso reduz a repetição e torna seus testes mais fáceis de manter.
- Segurança: Dados sensíveis como chaves de API ou credenciais de usuário podem ser armazenados em variáveis. Isso mantém os dados sensíveis fora de suas solicitações e coleções, melhorando a segurança dos seus testes.
Usar variáveis no corpo JSON de suas solicitações de API pode tornar seus testes mais dinâmicos, flexíveis, manuteníveis e seguros. É uma boa prática em testes de API que pode economizar tempo e ajudar você a criar testes mais robustos.
Como adicionar variáveis ao corpo JSON no Postman
Certo, vamos ao evento principal: adicionar variáveis ao corpo JSON no Postman. Aqui está um guia passo a passo:
Primeiro, você precisa definir sua variável. Você pode fazer isso nas variáveis de Ambiente ou Coleção. Para fazer isso:
Clique no ícone de engrenagem no canto superior direito para abrir o modal de Gerenciar Ambientes.

Clique em Adicionar para criar um novo ambiente ou selecione um existente.
Na nova linha que aparecer, insira seu nome de variável na coluna Variável

Salve sua alteração.
Agora, você pode usar essa variável no seu corpo JSON. Na aba Corpo da sua solicitação, selecione bruto e JSON no menu suspenso.

Na caixa de entrada de texto, você agora pode referenciar sua variável usando a sintaxe de chaves duplas.

Quando você enviar sua solicitação, o Postman substitui {{myVariable}}
pelo valor que você definiu em suas variáveis de ambiente ou coleção.
E é isso! Você adicionou com sucesso uma variável ao corpo JSON de uma solicitação do Postman.
Como adicionar variáveis ao corpo JSON no Apidog
Apidog é uma plataforma integrada de colaboração para documentação de API, depuração de API, simulação de API e testes automatizados de API. Ela combina ferramentas como Postman, Swagger, Mock e JMeter para lidar com o problema de sincronização de dados entre diferentes sistemas usando um conjunto de sistemas e um conjunto de dados.

Aqui estão algumas características principais do Apidog:
- Documentação de API: Uma vez que o documento da API está definido, a depuração de API, simulação de dados e testes de API podem ser utilizados diretamente sem necessidade de redefinição.
- Depuração de API: A ferramenta para documentação e depuração de desenvolvimento de API é a mesma, garantindo completa consistência entre a documentação da API e o desenvolvimento de API após a depuração.
- Simulação de API: Simulação inteligente gera automaticamente dados com base nos nomes dos campos, simulação avançada retorna dados especificados com base nas solicitações, e scripts de simulação modificam os dados simulados retornados.
- Testes Automatizados de API: Gere casos de teste a partir de APIs, adicione verificações visualmente e crie cenários de teste com ramificações e iterações facilmente.
O Apidog visa resolver o problema de sincronização de dados entre múltiplos sistemas. Ele fornece uma solução eficiente, pontual e precisa. É um conjunto completo de ferramentas que conecta todo o ciclo de vida da API, ajudando as equipes de P&D a implementar melhores práticas para o desenvolvimento de API com foco em design.
Criar Variáveis: Você pode criar variáveis no Apidog acessando o Gerenciamento de Ambientes (o botão de Configurações no canto superior direito do aplicativo) e selecionando a aba de Variáveis Globais.

Na nova linha que aparece, insira seu nome de variável na coluna Variável

Na aba Corpo da sua solicitação, selecione JSON no menu.

Na caixa de entrada de texto, você agora pode referenciar sua variável usando a sintaxe de chaves duplas.

É assim que você pode adicionar uma variável a um corpo JSON no Apidog.
Conclusão
Adicionar variáveis ao corpo JSON no Apidog e no Postman é uma técnica poderosa que pode simplificar seu processo de teste de API. Isso não apenas torna seus testes mais dinâmicos e flexíveis, mas também agiliza seu processo de teste de API.
Ao longo deste artigo, exploramos o que são variáveis, por que são importantes nos testes de API e como adicioná-las ao corpo JSON tanto no Postman quanto no APIdog. Com o conhecimento e as habilidades que você adquiriu, agora está preparado para levar seus testes de API ao próximo nível.
Lembre-se, a prática é fundamental quando se trata de dominar qualquer nova habilidade. Ao usar variáveis, você pode criar solicitações mais dinâmicas e reduzir a repetição em seus testes.