Pular para o conteúdo principal

Conceitos essenciais

Quando esses quatro designs ficam claros, todos os protocolos e cenários seguintes são simples:

  1. O modelo das três entidades: como Grupo / Ambiente / Requisição se relacionam
  2. Design de Pre-URL do ambiente: por que as requisições armazenam apenas caminhos relativos
  3. O pipeline de montagem do envio: como um envio transforma configuração em uma requisição real
  4. 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)':

ProtocoloScheme texto puroScheme criptografado
HTTPhttp://https://
WebSocketws://wss://
TCPtcp://tcps://
UDPudp://—
gRPCgrpc://grpcs://
MQTTmqtt://mqtts://

⚠️ Erro comum: o endereço base de um WebSocket deve ser escrito como ws:// / wss://. Se digitar https://, 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 é escritoVariáveis de ambienteVariáveis de runtimeUso 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ávelGera
{{$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 →