Umgebungen und Variablen

Eine Umgebung bündelt Werte, die deine Anfragen wiederverwenden können. Behalte die Adresse {{baseUrl}}/orders/{{orderId}} bei und wähle eine andere Umgebung, wenn du einen anderen Server oder ein anderes Konto benötigst.

Eine Umgebung anlegen und auswählen

Öffne die Umgebungen des Bereichs, füge eine hinzu und vergib einen eindeutigen Namen wie Development. Ergänze eine Zeile je Wert, beispielsweise baseUrl, orderId oder accessToken. Der Editor speichert Änderungen automatisch.

Wähle die Umgebung vor dem Senden in der oberen Leiste. Diese globale Auswahl zeigt Umgebungen der aktuellen Organisation und gilt für die geöffneten Anfragetabs. Editor und Seitenleiste gruppieren sie weiterhin nach Bereich. Prüfe die Auswahl nach einem Workspace-Wechsel oder dem Öffnen einer importierten Sammlung.

Eine Variable verwenden

Verwende doppelte geschweifte Klammern in URLs, Abfrageparametern, Headern, Authentifizierungseinstellungen und Textinhalten:

{{baseUrl}}/orders/{{orderId}}
Authorization: Bearer {{accessToken}}

Die Autovervollständigung schlägt Namen vor. Der URL-Editor unterscheidet bekannte von nicht aufgelösten Referenzen. Prüfe bei Problemen Schreibweise, Umgebung und vorhandenen Wert. Eine nicht aufgelöste Referenz kann im gesendeten Text verbleiben.

Skripte lesen und ändern Werte über pm.environment und pm.variables. Bei Sammlungsläufen liest pm.iterationData CSV-Spalten oder JSON-Eigenschaften. Iterationsdaten haben Vorrang vor gleichnamigen Umgebungswerten. Beispiele findest du unter Automatisierung und Tests.

Einen geheimen Wert speichern

Markiere Passwörter, Tokens und Schlüssel als geheim. Echo schützt diese Werte im verschlüsselten Speicher und blendet sie im Editor aus. Eine Anfrage, die einen geheimen Wert verwendet, sendet ihn weiterhin an das gewählte Ziel. Prüfe daher die Adresse vor dem Senden.

Exporte in verknüpfte Ordner enthalten keine geheimen Werte. Stelle diese auf einer anderen Maschine separat bereit, statt sie in Git abzulegen. Prüfe auch andere Felder und exportierte Dateien: Die Kennzeichnung einer Variablen schützt nicht automatisch andernorts eingefügten Inhalt.

Eine Azure-Key-Vault-Referenz auflösen

Wähle den Typ für Key-Vault-Referenzen und gib die URI des Geheimnisses an:

https://your-vault.vault.azure.net/secrets/api-token

Eine angehängte Version bindet die Referenz an eine bestimmte Version. Prüfe den Zugriff mit der Testfunktion. Das Gerät benötigt eine Azure-Identität mit Leseberechtigung für dieses Geheimnis. Die Anmeldung bei Gapfy gewährt keinen Zugriff auf den Tresor.

Echo speichert und synchronisiert die Referenz und löst den Wert für die Ausführung auf. Dieser bleibt für den eingestellten Zeitraum im Arbeitsspeicher, standardmäßig fünf Minuten. In den erweiterten Einstellungen änderst du den Zeitraum oder entfernst die gespeicherten Azure-Anmeldedaten. Behebe Zugriffsfehler, fehlende Geheimnisse oder Anmeldefehler vor der Ausführung.

Testdaten erzeugen

Dynamische Variablen benötigen keine Umgebungszeile. Beispiele sind {{$guid}}, {{$randomUUID}}, {{$timestamp}}, {{$isoTimestamp}}, {{$randomInt}}, {{$randomBoolean}} und {{$randomEmail}}. Vorschläge umfassen außerdem Namen, Städte, Länder, Telefonnummern, URLs, IP-Adressen, Wörter, Preise und Unternehmen.

Verwende sie für neue Beispieldaten. Für feste, wiederholbare Eingaben lade eine CSV- oder JSON-Datei im Sammlungsläufer.

Desktop-Mocks zuordnen

Die Mock-Option der Umgebung stellt eine verwaltete Basis-URL für die Mocks des Bereichs bereit. Verwende die von Echo angebotene Variable. Desktop-Mocks beantworten Aufrufe innerhalb von Echo und öffnen keinen Port für andere Anwendungen. Für eine gemeinsame HTTP-URL lies öffentliches Mock-Hosting.

Antworten vergleichen

Aktiviere den Vergleichsmodus und wähle bis zu vier Umgebungen. Ein Sendevorgang führt die Varianten parallel aus. Die Antwortbereiche können gemeinsam scrollen. Der strukturelle JSON-Vergleich kennzeichnet hinzugefügte, entfernte und geänderte Werte.

Jeder Bereich ist eine echte Ausführung. POST, PATCH oder DELETE können in allen ausgewählten Umgebungen Daten ändern. Wähle geeignete Testdatensätze, bevor du sendest. Der Vergleich hilft bei der Untersuchung von Unterschieden, beweist aber nicht das Verhalten sämtlicher Operationen.

Lies weiter unter Sammlungen und Freigaben oder Import und Export.