Gå til hovedinnhold

Kjernekonsepter

Når disse fire designene har klikket, er alt som følger enkelt:

  1. Modellen med tre entiteter: hvordan Grupp / Miljø / Forespørsel forholder seg til hverandre
  2. Miljøets Pre-URL-design: hvorfor forespørsler kun lagrer relative stier
  3. Monteringspipelinen ved sending: hvordan én Send gjør konfigurasjonen om til en ekte forespørsel
  4. 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)»:

ProtokollSkjema i klartekstKryptert skjema
HTTPhttp://https://
WebSocketws://wss://
TCPtcp://tcps://
UDPudp://—
gRPCgrpc://grpcs://
MQTTmqtt://mqtts://

⚠️ Vanlig feil: en WebSocket-basisadresse må skrives som ws:// / wss://. Skriver du https://, 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 skrivesMiljøvariablerKjøretidsvariablerTypisk 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:

VariabelGenererer
{{$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 →