Conceitos essenciais
Quando esses quatro designs ficam claros, todos os protocolos e cenários seguintes são simples:
- O modelo das três entidades: como Grupo / Ambiente / Requisição se relacionam
- Design de Pre-URL do ambiente: por que as requisições armazenam apenas caminhos relativos
- O pipeline de montagem do envio: como um envio transforma configuração em uma requisição real
- O sistema de variáveis: de onde
{{variable}}é resolvida, e as três camadas de variáveis
O modelo das três entidades
Por que o ambiente é vinculado ao grupo e não a cada requisição? Um grupo normalmente representa 'todas as APIs de um módulo sob um alvo de implantação'. Vincular no nível do grupo significa que trocar de ambiente move o grupo inteiro de uma vez — sem edições por requisição. Se uma única requisição precisa de um ambiente diferente, basta colocá-la em um grupo vinculado a esse ambiente.
Design de Pre-URL do ambiente
Este é o design mais importante — e o mais mal compreendido.
Requisições armazenam caminhos relativos; ambientes armazenam endereços base
Em ferramentas tradicionais, cada requisição armazena uma URL completa (https://api.example.com/v1/users), então mudar para um ambiente de teste significa substituir domínios em lote. Esta ferramenta inverte isso:
O scheme decide o protocolo e o TLS (importante!)
Os Pre-URLs são armazenados por protocolo, mas qual protocolo uma entrada realmente serve é decidido pelo scheme no início da URL. O scheme expressa tanto 'qual protocolo' quanto 'criptografado ou não (TLS)':
| Protocolo | Scheme texto puro | Scheme criptografado |
|---|---|---|
| HTTP | http:// | https:// |
| WebSocket | ws:// | wss:// |
| TCP | tcp:// | tcps:// |
| UDP | udp:// | — |
| gRPC | grpc:// | grpcs:// |
| MQTT | mqtt:// | mqtts:// |
⚠️ Erro comum: o endereço base de um WebSocket deve ser escrito como
ws:///wss://. Se digitarhttps://, será tratado como HTTP e a requisição WebSocket falhará por falta de endereço base. Mantenha a linha do protocolo e o scheme consistentes.
O pipeline de montagem do envio
Tocar em 'Enviar' não dispara um socket diretamente. O pipeline monta 'requisição + ambiente do grupo + variáveis' passo a passo em uma requisição real, e insere uma cadeia de ações antes e depois da chamada de rede:
Pontos-chave:
- As cadeias de ações só rodam quando 'executar scripts' está ativado. No app, tocar em Enviar as executa por padrão; envios automatizados / MCP devem ativá-las explicitamente. Com scripts desativados, tokens injetados no pré-envio ou criptografia simplesmente não acontecem — é exatamente por isso que o controle negativo 'sem token → 401' em recipes se comporta assim.
- Scripts de pré-envio reescrevem a requisição que está prestes a sair; scripts pós-resposta reescrevem a resposta que você recebeu. Ambos podem ler e escrever variáveis de runtime.
O sistema de variáveis
Há três tipos de 'variáveis' com escopos diferentes. Confundi-las é a armadilha mais comum de iniciantes.
O que {{name}} realmente resolve?
| Onde é escrito | Variáveis de ambiente | Variáveis de runtime | Uso típico |
|---|---|---|---|
{{name}} (em URL / params / headers / body) | ✅ | ❌ | Referenciar configuração de ambiente, preenchimento dinâmico |
| Ler variáveis dentro de scripts | ✅ | ✅ | Passar tokens de login entre requisições, etc. |
Mnemônico:
{{}}só vê variáveis 'de configuração'; scripts podem ler as três camadas. Variáveis de runtime são o 'quadro de runtime' — apenas scripts podem escrever nele, e{{}}nunca olha para lá.
Por que {{authToken}} não consegue ler o token salvo no login? Porque o script de login o armazenou na camada de runtime, que {{}} não interpreta. A abordagem correta é um script de pré-envio que o lê e injeta o cabeçalho (veja recipes, cenário 1).
Variáveis dinâmicas {{$xxx}}
Dentro de {{}} também há um conjunto de variáveis dinâmicas integradas, geradas novas a cada avaliação, usáveis diretamente em URL / params / headers / body:
| Variável | Gera |
|---|---|
{{$timestamp}} / {{$timestampMs}} | Timestamp Unix em segundos / milissegundos |
{{$isoTimestamp}} | ISO8601 UTC |
{{$uuid}} / {{$guid}} | UUID v4 |
{{$randomInt}} / {{$randomInt min,max}} | Inteiro aleatório (padrão 0..1000) |
{{$randomBoolean}} {{$randomFullName}} {{$randomEmail}} {{$randomPhoneNumber}} {{$randomIpv4}} {{$randomIpv6}} {{$randomUrl}} {{$randomColor}} {{$randomHexadecimal}} {{$randomAlphaNumeric}} {{$randomCity}} {{$randomCountry}} {{$randomDateRecent}} {{$randomPrice}} {{$randomWord}} {{$randomLorem}} {{$randomCompanyName}} etc. | Dados de exemplo aleatórios variados |
Exemplo: GET /echo?ts={{$timestamp}}&u={{$uuid}} — na prática, cada envio substitui ts/u por valores reais novos.
Resumo
- Requisições armazenam fragmentos de caminho; ambientes fornecem endereços base por protocolo via Pre-URLs; o scheme decide protocolo + TLS.
- Enviar é um pipeline de montagem: juntar URL → interpolar → configurações de transporte → cadeia de pré-envio → rede → cadeia pós-resposta.
- Variáveis têm três camadas:
{{}}lê variáveis de configuração, scripts leem as três; passe tokens com scripts, não com{{}}.
Próximo: scripts →