Kjernekonsepter
Når disse fire designene har klikket, er alt som følger enkelt:
- Modellen med tre entiteter: hvordan Grupp / Miljø / Forespørsel forholder seg til hverandre
- Miljøets Pre-URL-design: hvorfor forespørsler kun lagrer relative stier
- Monteringspipelinen ved sending: hvordan én Send gjør konfigurasjonen om til en ekte forespørsel
- Variabelsystemet: hvor
{{variable}}løses fra, og de tre variabellagene
Modellen med tre entiteter
Hvorfor er miljøet bundet til gruppen i stedet for hver forespørsel? En gruppe representerer vanligvis «alle API-ene i én modul under ett utrullingsmål». Binding på gruppenivå betyr at miljøbytte flytter hele gruppen på en gang — ingen redigering per forespørsel. Trenger en enkelt forespørsel et annet miljø, legger du den bare i en gruppe bundet til det miljøet.
Miljøets Pre-URL-design
Dette er det viktigste — og mest misforståtte — designet.
Forespørsler lagrer relative stier; miljøer lagrer basisadresser
I tradisjonelle verktøy lagrer hver forespørsel en full URL (https://api.example.com/v1/users), så et miljøbytte til test betyr masseutskifting av domener. Dette verktøyet snur det på hodet:
Skjemaet avgjør protokoll og TLS (nøkkelen!)
Pre-URL-er lagres per protokoll, men hvilken protokoll en oppføring faktisk betjener avgjøres av skjemaet i starten av URL-en. Skjemaet uttrykker både «hvilken protokoll» og «kryptert eller ikke (TLS)»:
| Protokoll | Skjema i klartekst | Kryptert skjema |
|---|---|---|
| HTTP | http:// | https:// |
| WebSocket | ws:// | wss:// |
| TCP | tcp:// | tcps:// |
| UDP | udp:// | — |
| gRPC | grpc:// | grpcs:// |
| MQTT | mqtt:// | mqtts:// |
⚠️ Vanlig feil: en WebSocket-basisadresse må skrives som
ws:///wss://. Skriver duhttps://, behandles den som HTTP, og WebSocket-forespørselen feiler på grunn av manglende basisadresse. Hold protokollinjen og skjemaet konsistente.
Monteringspipeline for sending
Å trykke «Send» skyter ikke av en socket direkte. Pipelinen monterer «forespørsel + gruppens miljø + variabler» trinn for trinn til en ekte forespørsel, og setter inn en handlingskjede før og etter nettverkskallet:
Nøkkelpunkter:
- Handlingskjeder kjører bare når «kjør skript» er på. Å trykke Send i appen kjører dem som standard; automatiske / MCP-sendinger må eksplisitt melde seg inn. Med skript av skjer ikke token-innsprøytning før sending eller kryptering i det hele tatt — det er nettopp derfor den negative kontrollen «ingen token → 401» i oppskriftene oppfører seg slik.
- Skript før sending omskriver forespørselen som er i ferd med å gå ut; skript etter svar omskriver svaret du fikk tilbake. Begge kan lese og skrive kjøretidsvariabler.
Variabelsystemet
Det finnes tre typer «variabler» med ulikt omfang. Å blande dem sammen er den vanligste nybegynnerfellen.
Hva kan egentlig {{name}} løse?
| Hvor det skrives | Miljøvariabler | Kjøretidsvariabler | Typisk bruk |
|---|---|---|---|
{{name}} (i URL / params / headers / body) | ✅ | ❌ | Referere miljøkonfigurasjon, dynamisk utfylling |
| Lese variabler inne i skript | ✅ | ✅ | Overføre innloggingstokens mellom forespørsler, osv. |
Huskeregel:
{{}}ser bare «konfigurasjonstype»-variabler; skript kan lese alle tre lagene. Kjøretidsvariabler er «kjøretidstavlen» — bare skript kan kritte på den, og{{}}ser aldri dit.
Hvorfor kan ikke {{authToken}} lese tokenet som lagres ved innlogging? Fordi innloggingsskriptet lagret det på kjøretidslaget, som {{}} ikke parser. Riktig tilnærming er et skript før sending som leser det og injiserer headeren (se oppskrifter, scenario 1).
Dynamiske variabler {{$xxx}}
Inne i {{}} finnes det også et sett med innebygde dynamiske variabler, generert fersk ved hver evaluering, brukbare direkte i URL / params / headers / body:
| Variabel | Genererer |
|---|---|
{{$timestamp}} / {{$timestampMs}} | Unix-tidsstempel i sekunder / millisekunder |
{{$isoTimestamp}} | ISO8601 UTC |
{{$uuid}} / {{$guid}} | UUID v4 |
{{$randomInt}} / {{$randomInt min,max}} | Tilfeldig heltall (standard 0..1000) |
{{$randomBoolean}} {{$randomFullName}} {{$randomEmail}} {{$randomPhoneNumber}} {{$randomIpv4}} {{$randomIpv6}} {{$randomUrl}} {{$randomColor}} {{$randomHexadecimal}} {{$randomAlphaNumeric}} {{$randomCity}} {{$randomCountry}} {{$randomDateRecent}} {{$randomPrice}} {{$randomWord}} {{$randomLorem}} {{$randomCompanyName}} osv. | Diverse tilfeldige eksempeldata |
Eksempel: GET /echo?ts={{$timestamp}}&u={{$uuid}} — i praksis erstatter hver sending ts/u med ferske reelle verdier.
Oppsummering
- Forespørsler lagrer sti-fragmenter; miljøer leverer basisadresser per protokoll via Pre-URL-er; skjemaet avgjør protokoll + TLS.
- Sending er en monteringspipeline: sett sammen URL → interpoler → transportinnstillinger → kjede før sending → nettverk → kjede etter svar.
- Variabler kommer i tre lag:
{{}}leser konfigurasjonstypevariabler, skript leser alle tre; send tokens med skript, ikke{{}}.
Neste: scripting →