Concetti chiave
Una volta che questi quattro design saranno chiari, ogni protocollo e scenario successivo sarà semplice:
- Il modello delle tre entità: come si relazionano Gruppo / Ambiente / Richiesta
- Design Pre-URL dell'ambiente: perché le richieste memorizzano solo percorsi relativi
- La pipeline di assemblaggio dell'invio: come un Invio trasforma la configurazione in una richiesta reale
- 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)»:
| Protocollo | Schema in chiaro | Schema cifrato |
|---|---|---|
| HTTP | http:// | https:// |
| WebSocket | ws:// | wss:// |
| TCP | tcp:// | tcps:// |
| UDP | udp:// | — |
| gRPC | grpc:// | grpcs:// |
| MQTT | mqtt:// | mqtts:// |
⚠️ Errore comune: l'indirizzo base di un WebSocket deve essere scritto come
ws:///wss://. Se digitihttps://, 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 scritto | Variabili d'ambiente | Variabili di runtime | Uso 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:
| Variabile | Genera |
|---|---|
{{$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.
Riepilogo
- 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 →