Variáveis

Uma variável é um valor que pode ser aplicado em certos parâmetros de uma requisição. Ao invés de digitar o mesmo valor repetidamente em várias requisições, você pode usar uma variável para isso, poupando esforço se precisar mudar esse valor - apenas mude o valor da variável onde é definido, em um único lugar.

Há duas classes de variáveis: variáveis de coleção e variáveis de ambiente.

Variáveis de coleção

Variáveis de coleção ficam disponíveis para todas as requisições de uma coleção. Para vê-las, clique na seção Variáveis de uma coleção, no painel esquerdo.

Variáveis de ambiente

Variáveis de ambiente também ficam disponíveis para todas as requisições de uma coleção; contudo, elas apenas serão consideradas para uso se o ambiente for o atual / ativo. Para vê-las, clique no ambiente, no painel esquerdo.

Editando variáveis

Você pode adicionar uma nova variável clicando no botão "+", acima da tabela, à esquerda. Para editar uma variável, dê um duplo-clique em um campo dela na tabela e digite texto.

Para rearranjar suas variáveis, clique, segure e arraste o símbolo "::" que fica à esquerda da linha na tabela, e arraste para a posição onde quiser colocar sua variável.

Para remover uma variável, clique no botão "X" da sua linha, à direita, na tabela.

Uma variável pode estar habilitada ou desabilitada. Apenas variáveis habilitadas serão consideradas para resolução.

Variáveis marcadas como secretas permitem um melhor controle de dados sensíveis ao exportar sua coleção ou ambiente. Leia mais na página Exportar e Importar.

Como usar uma variável

Variáveis podem ser usadas nos seguintes campos de uma requisição:

• URL
• Nomes e valores de cabeçalhos HTTP
• Valores de autenticação
• Requisição HTTP
  • Corpo-texto: conteúdo
  • Corpo-arquivo: caminho do arquivo
  • Corpo form URL encoded: nomes e valores dos parâmetros
  • Corpo multipart form data: nomes e valores dos parâmetros, incluindo caminhos de arquivos
  • Corpo GraphQL: conteúdo do campo variáveis
• Mensagem WebSocket
  • Corpo-texto: conteúdo
  • Corpo-arquivo: caminho do arquivo
• Repetidora HTTP
  • Texto dos dados de entrada
  • Caminho do arquivo de dados de entrada

Para usar uma variável, digite {{NomeDaVariável}} no campo onde deseja aplicá-la.

Por exemplo: se a URL de uma requisição for {{BaseUrl}}/index.html e houver uma variável de nome BaseUrl e valor http://www.pudim.com.br, ao enviar a requisição, o valor resolvido da URL será http://www.pudim.com.br/index.html.

Para URLs de requisições, você pode passar o mouse em cima da caixa de texto da URL para prever a URL resolvida.

A imagem abaixo mostra como usar uma variável em um corpo-texto. Nele, o {{NomeDaVariável}} aparecerá destacado em amarelo.

Lógica de resolução de variáveis

A lógica de resolução é:

1. Apenas variáveis habilitadas serão consideradas.
2. Variáveis de coleção serão juntadas com as variáveis do ambiente atual. Se não houver ambiente atual, então apenas variáveis de coleção.
3. Variáveis de ambiente têm precedência - se houver duas variáveis declaradas com o mesmo nome na coleção e no ambiente, a variável do ambiente será a escolhida.
4. Todo campo de requisição que permite uso de variáveis será analisado para verificar se ele tem um molde (template) de variável, como por exemplo, {{NOME_DA_VARIÁVEL}}. Se um molde for encontrado e houver uma variável habilitada para ele, o molde será trocado pelo valor da variável. Caso contrário, o texto do molde continuará no lugar.

Variáveis predefinidas

As variáveis predefinidas fornecem valores aleatórios ou do momento, que podem ser usados nas suas requisições.

Molde da variável	Valor de exemplo
{{ $guid }}	7cc34984-e276-4cad-948d-25a1d4686b78
{{ $now }}	2024-05-28T16:33:30.5687994-03:00
{{ $today }}	2024-05-28
{{ $timestamp }}	1728309929
{{ $randomBirthDate }}	2015-04-22
{{ $randomBirthDateOver18 }}	1966-03-17
{{ $randomInt }}	455659758
{{ $randomQuantity }}	34 (valor entre 1 e 1000)
{{ $randomFullName }}	(ver abaixo)
{{ $randomManFullName }}	Ricardo Torres de La Cruz
{{ $randomWomanFullName }}	Viviana Fermi Veronesi
{{ $randomFirstName }}	(ver abaixo)
{{ $randomManFirstName }}	Ricardo
{{ $randomWomanFirstName }}	Viviana
{{ $randomLastName }}	Fermi
{{ $randomCPF }}	123.456.789-09
{{ $randomCPFDigitsOnly }}	12345678909
{{ $randomCNPJ }}	31.616.591/0001-50
{{ $randomCNPJDigitsOnly }}	31616591000150

* CPF, CNPJ: Cadastro de Pessoa Física / Jurídica.

Essas variáveis podem ser aplicadas tanto dentro das requisições:

Como dentro de variáveis de coleção e ambiente, para gerar valores:

Capturando resposta e guardando em variáveis

Leia mais aqui.