Zum Hauptinhalt springen

Kernkonzepte

Wenn diese vier Designs klar sind, ist jedes folgende Protokoll und Szenario unkompliziert:

  1. Das Drei-Entitäten-Modell: wie Gruppe / Umgebung / Request zusammenhängen
  2. Das Umgebung-Pre-URL-Design: warum Requests nur relative Pfade speichern
  3. Die Sende-Assemblierungs-Pipeline: wie ein „Senden“ aus Konfiguration eine echte Anfrage macht
  4. Das Variablensystem: woher {{variable}} aufgelöst wird und die drei Variablen-Ebenen

Das Drei-Entitäten-Modell​

Warum ist die Umgebung an die Gruppe statt an jeden Request gebunden? Eine Gruppe steht meist für „alle APIs eines Moduls unter einem Deployment-Ziel“. Die Bindung auf Gruppenebene bedeutet: Beim Umgebungswechsel wird die ganze Gruppe auf einmal umgestellt — ohne Anpassung jedes einzelnen Requests. Braucht ein einzelner Request eine andere Umgebung, legen Sie ihn einfach in eine Gruppe, die an diese Umgebung gebunden ist.


Umgebung-Pre-URL-Design​

Das ist der wichtigste — und am häufigsten missverstandene — Punkt.

Requests speichern relative Pfade; Umgebungen speichern Basisadressen​

In klassischen Tools speichert jeder Request eine vollständige URL (https://api.example.com/v1/users), ein Wechsel in die Testumgebung bedeutet also, Domains massenhaft zu ersetzen. Dieses Tool dreht den Spieß um:

Das Scheme bestimmt Protokoll und TLS (wichtig!)​

Pre-URLs werden pro Protokoll gespeichert, aber welches Protokoll ein Eintrag tatsächlich bedient, entscheidet das Scheme am Anfang der URL. Das Scheme drückt sowohl „welches Protokoll“ als auch „verschlüsselt oder nicht (TLS)“ aus:

ProtokollUnverschlüsseltVerschlüsselt
HTTPhttp://https://
WebSocketws://wss://
TCPtcp://tcps://
UDPudp://—
gRPCgrpc://grpcs://
MQTTmqtt://mqtts://

⚠️ Häufiger Fehler: Eine WebSocket-Basisadresse muss als ws:// / wss:// geschrieben werden. Tippen Sie https://, wird sie als HTTP behandelt und die WebSocket-Anfrage schlägt wegen fehlender Basisadresse fehl. Halten Sie Protokollzeile und Scheme konsistent.


Die Sende-Assemblierungs-Pipeline​

Ein Tap auf „Senden“ feuert nicht direkt einen Socket. Die Pipeline assembliert „Request + Umgebung der Gruppe + Variablen“ Schritt für Schritt zu einer echten Anfrage und fügt vor und nach dem Netzwerkaufruf eine Aktionskette ein:

Wichtige Punkte:

  • Aktionsketten laufen nur, wenn „Skripte ausführen“ aktiviert ist. Ein Tap auf Senden in der App führt sie standardmäßig aus; automatisierte / MCP-Sendes müssen dies explizit aktivieren. Ohne Skripte passiert schlicht nichts — kein vorab injiziertes Token, keine Verschlüsselung. Genau deshalb verhält sich der „kein Token → 401“-Negativtest in den Rezepten so.
  • Pre-Send-Skripte schreiben die Anfrage um, die gerade rausgeht; Post-Response-Skripte schreiben die Antwort um, die Sie erhalten haben. Beide können Laufzeitvariablen lesen und schreiben.

Das Variablensystem​

Es gibt drei Arten von „Variablen“ mit unterschiedlichen Gültigkeitsbereichen. Sie zu verwechseln ist die häufigste Anfängerfalle.

Was kann {{name}} tatsächlich auflösen?​

Wo geschriebenUmgebungsvariablenLaufzeitvariablenTypischer Einsatz
{{name}} (in URL / Params / Headers / Body)✅❌Auf Umgebungskonfiguration verweisen, dynamisch befüllen
Variablen in Skripten lesen✅✅Login-Tokens requestübergreifend weiterreichen usw.

Merksatz: {{}} sieht nur „Konfigurations-Variablen“; Skripte können alle drei Ebenen lesen. Laufzeitvariablen sind die „Laufzeit-Tafel“ — nur Skripte dürfen darauf schreiben, und {{}} schaut nie dorthin.

Warum kann {{authToken}} den beim Login gespeicherten Token nicht lesen? Weil das Login-Skript ihn in der Laufzeit-Ebene abgelegt hat, die {{}} nicht auswertet. Der richtige Weg ist ein Pre-Send-Skript, das ihn liest und den Header injiziert (siehe Rezepte, Szenario 1).

Dynamische Variablen {{$xxx}}​

In {{}} gibt es außerdem eingebaute dynamische Variablen, die bei jeder Auswertung neu erzeugt werden und direkt in URL / Params / Headers / Body nutzbar sind:

VariableErzeugt
{{$timestamp}} / {{$timestampMs}}Unix-Zeitstempel in Sekunden / Millisekunden
{{$isoTimestamp}}ISO8601 UTC
{{$uuid}} / {{$guid}}UUID v4
{{$randomInt}} / {{$randomInt min,max}}Zufällige Ganzzahl (Standard 0..1000)
{{$randomBoolean}} {{$randomFullName}} {{$randomEmail}} {{$randomPhoneNumber}} {{$randomIpv4}} {{$randomIpv6}} {{$randomUrl}} {{$randomColor}} {{$randomHexadecimal}} {{$randomAlphaNumeric}} {{$randomCity}} {{$randomCountry}} {{$randomDateRecent}} {{$randomPrice}} {{$randomWord}} {{$randomLorem}} {{$randomCompanyName}} usw.Allerlei zufällige Beispieldaten

Beispiel: GET /echo?ts={{$timestamp}}&u={{$uuid}} — in der Praxis werden ts/u bei jedem Senden durch frische echte Werte ersetzt.


Zusammenfassung​

  • Requests speichern Pfadfragmente; Umgebungen liefern pro Protokoll Basisadressen über Pre-URLs; das Scheme bestimmt Protokoll + TLS.
  • Senden ist eine Assemblierungs-Pipeline: URL zusammensetzen → interpolieren → Transporteinstellungen → Pre-Send-Kette → Netzwerk → Post-Response-Kette.
  • Variablen gibt es auf drei Ebenen: {{}} liest Konfigurations-Variablen, Skripte lesen alle drei; Tokens laufen über Skripte, nicht über {{}}.

Weiter: Skripte →