Kernkonzepte
Wenn diese vier Designs klar sind, ist jedes folgende Protokoll und Szenario unkompliziert:
- Das Drei-Entitäten-Modell: wie Gruppe / Umgebung / Request zusammenhängen
- Das Umgebung-Pre-URL-Design: warum Requests nur relative Pfade speichern
- Die Sende-Assemblierungs-Pipeline: wie ein „Senden“ aus Konfiguration eine echte Anfrage macht
- 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:
| Protokoll | Unverschlüsselt | Verschlüsselt |
|---|---|---|
| HTTP | http:// | https:// |
| WebSocket | ws:// | wss:// |
| TCP | tcp:// | tcps:// |
| UDP | udp:// | — |
| gRPC | grpc:// | grpcs:// |
| MQTT | mqtt:// | mqtts:// |
⚠️ Häufiger Fehler: Eine WebSocket-Basisadresse muss als
ws:///wss://geschrieben werden. Tippen Siehttps://, 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 geschrieben | Umgebungsvariablen | Laufzeitvariablen | Typischer 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:
| Variable | Erzeugt |
|---|---|
{{$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 →