Como Adicionar Variáveis ao Corpo JSON no Postman?

Aprenda a adicionar variáveis ao corpo JSON no Postman, uma técnica poderosa que pode tornar seu processo de teste de API mais dinâmico e eficiente. Descubra os benefícios de usar variáveis e siga nosso guia passo a passo para começar.

Miguel Oliveira

Miguel Oliveira

7 agosto 2025

Como Adicionar Variáveis ao Corpo JSON no Postman?

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.

💡
Pronto para melhorar seus testes de API? Experimente o Apidog! É uma ferramenta poderosa para testes de API eficientes. E adivinha? Você pode baixá-lo GRÁTIS! Não espere, comece sua jornada com o Apidog hoje!
button

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.

Postman homepage

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:

  1. 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.
  2. 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.
  3. 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.
  4. 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.
  5. 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.

Gerenciar modal de 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

criar um novo ambiente

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.

Aba Corpo do Postman

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

Campo de texto do Postman

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.

Interface principal do Apidog

Aqui estão algumas características principais do Apidog:

  1. 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.
  2. 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.
  3. 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.
  4. 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.

button

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.

Gerenciamento de Ambientes do Apidog

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

insira seu nome de variável na coluna Variável

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

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.

campo de texto no Apidog

É 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.

button

Explore more

Como acessar a API do Claude 3.7 Sonnet e testar usando Apidog

Como acessar a API do Claude 3.7 Sonnet e testar usando Apidog

Se você está empolgado com o último lançamento da Anthropic, Claude 3.7 Sonnet, e quer explorar suas capacidades através da API enquanto o testa com o Apidog, você está no lugar certo. 💡Antes de começarmos, deixe-me fazer uma rápida observação: baixe o Apidog gratuitamente hoje e otimize seu processo de teste de API, especialmente para explorar os poderosos recursos do Claude 3.7 Sonnet—perfeito para desenvolvedores que desejam testar modelos de IA de ponta como este!botão Vamos começar com a

25 fevereiro 2025

Como passar o x-API-key no cabeçalho?

Como passar o x-API-key no cabeçalho?

Desvende os segredos da segurança eficaz de APIs, dominando como passar x-API-key nos cabeçalhos. Este guia abrangente revelará a importância desse processo e como ferramentas como o Apidog podem facilitar seus esforços. Continue lendo para garantir que suas interações com a API permaneçam seguras!

12 agosto 2024

Como corrigir o erro HTTP 405 Método Não Permitido no Postman

Como corrigir o erro HTTP 405 Método Não Permitido no Postman

O código de erro HTTP 405 ocorre quando você tenta acessar um servidor usando uma chave de API ou token de acesso inválido ou ausente. Neste artigo, veremos mais sobre o erro 405 e como corrigi-lo.

11 agosto 2024

Pratique o design de API no Apidog

Descubra uma forma mais fácil de construir e usar APIs