Passa al contenuto principale

Concetti chiave

Una volta che questi quattro design saranno chiari, ogni protocollo e scenario successivo sarà semplice:

  1. Il modello delle tre entità: come si relazionano Gruppo / Ambiente / Richiesta
  2. Design Pre-URL dell'ambiente: perché le richieste memorizzano solo percorsi relativi
  3. La pipeline di assemblaggio dell'invio: come un Invio trasforma la configurazione in una richiesta reale
  4. Il sistema di variabili: da dove risolve {{variable}} e i tre livelli di variabili

Il modello delle tre entità​

Perché l'ambiente è associato al gruppo invece che a ogni singola richiesta? Un gruppo di solito rappresenta «tutte le API di un modulo sotto un target di distribuzione». Associare a livello di gruppo significa che cambiare ambiente sposta tutto il gruppo in una volta — senza modifiche per singola richiesta. Se una singola richiesta ha bisogno di un ambiente diverso, mettila semplicemente in un gruppo associato a quell'ambiente.


Design Pre-URL dell'ambiente​

Questo è il design più importante — e più frainteso.

Le richieste memorizzano percorsi relativi; gli ambienti memorizzano indirizzi base​

Negli strumenti tradizionali ogni richiesta memorizza un URL completo (https://api.example.com/v1/users), quindi passare a un ambiente di test significa sostituire i domini in batch. Questo strumento ribalta l'approccio:

Lo schema decide il protocollo e il TLS (punto chiave!)​

I Pre-URL sono memorizzati per protocollo, ma quale protocollo serve davvero una voce è deciso dallo schema all'inizio dell'URL. Lo schema esprime sia «quale protocollo» sia «cifrato o meno (TLS)»:

ProtocolloSchema in chiaroSchema cifrato
HTTPhttp://https://
WebSocketws://wss://
TCPtcp://tcps://
UDPudp://—
gRPCgrpc://grpcs://
MQTTmqtt://mqtts://

⚠️ Errore comune: l'indirizzo base di un WebSocket deve essere scritto come ws:// / wss://. Se digiti https://, viene trattato come HTTP e la richiesta WebSocket fallisce per mancanza di un indirizzo base. Mantieni coerenti la riga del protocollo e lo schema.


La pipeline di assemblaggio dell'invio​

Toccare «Invia» non scatta direttamente un socket. La pipeline assembla passo dopo passo «richiesta + ambiente del gruppo + variabili» in una richiesta reale, e inserisce una catena di azioni prima e dopo la chiamata di rete:

Punti chiave:

  • Le catene di azioni girano solo quando «esegui script» è attivo. Toccare Invia nell'app le esegue per impostazione predefinita; gli invii automatici / MCP devono attivarle esplicitamente. Con gli script disattivati, i token iniettati prima dell'invio o la crittografia semplicemente non avvengono — è esattamente per questo che il controllo negativo «nessun token → 401» in recipes si comporta così.
  • Gli script di pre-invio riscrivono la richiesta che sta per uscire; gli script post-risposta riscrivono la risposta ricevuta. Entrambi possono leggere e scrivere le variabili di runtime.

Il sistema di variabili​

Ci sono tre tipi di «variabili» con ambiti diversi. Confonderle è la trappola più comune per i principianti.

Cosa può risolvere davvero {{name}}?​

Dove viene scrittoVariabili d'ambienteVariabili di runtimeUso tipico
{{name}} (in URL / params / headers / body)✅❌Riferimento alla configurazione d'ambiente, riempimento dinamico
Leggere variabili dentro gli script✅✅Passare token di login tra richieste, ecc.

Mnemonica: {{}} vede solo le variabili «di configurazione»; gli script possono leggere tutti e tre i livelli. Le variabili di runtime sono la «lavagna di runtime» — solo gli script possono scriverci, e {{}} non guarda mai lì.

Perché {{authToken}} non può leggere il token salvato al login? Perché lo script di login l'ha memorizzato nel livello runtime, che {{}} non parsa. L'approccio corretto è uno script di pre-invio che lo legge e inietta l'header (vedi recipes, scenario 1).

Variabili dinamiche {{$xxx}}​

Dentro {{}} c'è anche un insieme di variabili dinamiche integrate, generate di fresco a ogni valutazione, utilizzabili direttamente in URL / params / headers / body:

VariabileGenera
{{$timestamp}} / {{$timestampMs}}Timestamp Unix in secondi / millisecondi
{{$isoTimestamp}}ISO8601 UTC
{{$uuid}} / {{$guid}}UUID v4
{{$randomInt}} / {{$randomInt min,max}}Intero casuale (predefinito 0..1000)
{{$randomBoolean}} {{$randomFullName}} {{$randomEmail}} {{$randomPhoneNumber}} {{$randomIpv4}} {{$randomIpv6}} {{$randomUrl}} {{$randomColor}} {{$randomHexadecimal}} {{$randomAlphaNumeric}} {{$randomCity}} {{$randomCountry}} {{$randomDateRecent}} {{$randomPrice}} {{$randomWord}} {{$randomLorem}} {{$randomCompanyName}} ecc.Vari dati di esempio casuali

Esempio: GET /echo?ts={{$timestamp}}&u={{$uuid}} — in pratica ogni invio sostituisce ts/u con valori reali di fresco.


  • Le richieste memorizzano frammenti di percorso; gli ambienti forniscono indirizzi base per protocollo tramite Pre-URL; lo schema decide protocollo + TLS.
  • Inviare è una pipeline di assemblaggio: unire URL → interpolare → impostazioni di trasporto → catena di pre-invio → rete → catena post-risposta.
  • Le variabili arrivano in tre livelli: {{}} legge le variabili di configurazione, gli script leggono tutti e tre; passa i token con gli script, non con {{}}.

Prossimo: scripting →