Ambientes e variáveis

Um ambiente reúne valores que suas requisições podem reutilizar. Mantenha o endereço como {{baseUrl}}/orders/{{orderId}} e troque o ambiente selecionado quando precisar de outro servidor ou outra conta.

Crie e selecione um ambiente

Abra os ambientes do espaço, adicione um ambiente e escolha um nome claro, como Development. Acrescente uma linha para cada valor, por exemplo baseUrl, orderId e accessToken. O editor salva as alterações automaticamente.

Selecione o ambiente ativo na barra superior antes de enviar. Esse seletor global lista os ambientes da organização atual e aplica a escolha às abas de requisições abertas. O editor e a barra lateral continuam agrupando os ambientes por espaço. Confira a seleção depois de trocar de workspace ou abrir uma coleção importada.

Use uma variável

Use chaves duplas em URLs, parâmetros de consulta, cabeçalhos, configurações de autenticação e corpos de texto:

{{baseUrl}}/orders/{{orderId}}
Authorization: Bearer {{accessToken}}

O preenchimento automático sugere nomes, e o editor de URL destaca referências conhecidas e não resolvidas. Quando um nome não resolver, confira a escrita, o ambiente selecionado e a existência de um valor. Uma referência não resolvida pode continuar no texto enviado.

Scripts podem ler e alterar valores com pm.environment e pm.variables. O executor de coleções também lê colunas CSV ou propriedades JSON com pm.iterationData. Os dados da iteração têm prioridade sobre um valor de mesmo nome no ambiente. Veja exemplos em automação e testes.

Guarde um segredo

Marque como secreto um valor que contenha senha, token ou chave. O Echo protege esses valores no armazenamento criptografado e os oculta no editor. Uma requisição que usa um segredo ainda o envia ao destino escolhido, então confira o endereço antes de enviar.

Valores secretos ficam fora da exportação para uma pasta vinculada. Informe-os separadamente na outra máquina, sem incluí-los no Git. Revise também os outros campos e arquivos exportados: marcar uma variável não torna secreto um conteúdo colado em outro lugar.

Resolva uma referência do Azure Key Vault

Escolha o tipo de referência do Key Vault e informe a URI de um segredo, por exemplo:

https://your-vault.vault.azure.net/secrets/api-token

Acrescente a versão no final para fixar uma versão específica. Use a ação de teste para conferir o acesso. O dispositivo precisa de uma identidade Azure com permissão de leitura desse segredo; entrar no Gapfy não concede acesso ao cofre.

O Echo salva e sincroniza a referência e resolve seu valor para a execução. O valor permanece em memória durante o período configurado, de cinco minutos por padrão. As configurações avançadas permitem mudar esse período ou esquecer as credenciais Azure. Se houver acesso negado, segredo ausente ou falha de login, resolva o problema antes de executar a requisição.

Gere dados de teste

Variáveis dinâmicas dispensam uma linha no ambiente. Entre elas estão {{$guid}}, {{$randomUUID}}, {{$timestamp}}, {{$isoTimestamp}}, {{$randomInt}}, {{$randomBoolean}} e {{$randomEmail}}. As sugestões também incluem nomes, cidades, países, telefones, URLs, endereços IP, palavras, preços e empresas.

Use essas variáveis quando precisar de novos exemplos. Para entradas fixas e reproduzíveis, carregue um arquivo CSV ou JSON no executor de coleções.

Use um ambiente com mocks do desktop

A opção de mock do ambiente fornece uma URL base gerenciada para os mocks do espaço. Use a variável oferecida pelo Echo. Mocks do desktop respondem a chamadas dentro do próprio Echo e não abrem uma porta para outra aplicação. Consulte hospedagem pública de mocks se precisar de uma URL HTTP compartilhada.

Compare respostas

Ative o modo de comparação e selecione até quatro ambientes. Envie uma vez para executar as variantes em paralelo. Os painéis podem rolar juntos, e a comparação estrutural de JSON identifica valores adicionados, removidos e alterados.

Cada painel corresponde a uma execução real. Um POST, PATCH ou DELETE pode alterar dados em todos os ambientes selecionados. Escolha registros adequados para o teste antes de enviar. A comparação ajuda a investigar diferenças, mas não comprova o comportamento de todas as operações.

Continue em coleções e compartilhamento ou importação e exportação.