Variablen

Was Variablen sind

Variablen sind wiederverwendbare Name/Wert-Paare, die Sie einmal definieren und in Ihren API-Prüfungen referenzieren. Anstatt dieselbe Basis-URL, denselben Token oder dieselbe Konto-ID in jeder Prüfung fest zu codieren, speichern Sie den Wert als Variable und verweisen über den Namen darauf — ändern Sie ihn an einer Stelle, und jede Prüfung, die ihn verwendet, übernimmt den neuen Wert.

Sie können Variablen in vielen Teilen einer API-Prüfung einsetzen:

URLs — Anfrage-URLs dynamisch zusammensetzen.
Body — Variablen direkt in den Body von POST- oder PUT-Anfragen einfügen.
Header — Variablen in Header-Werten für mehr Flexibilität verwenden.
Query-Parameter — GET-Anfragen mit dynamischen Query-Parametern erweitern.
Basisauthentifizierung — Benutzername und Passwort übergeben, ohne sie in jede Prüfung fest zu codieren.

Variablen verwalten

Öffnen Sie die Variablen-Seite, um Variablen zu erstellen, zu bearbeiten und zu löschen. Variablen sind an Ihr Team gebunden, sodass alle im Team sie in ihren Prüfungen referenzieren können.

Eine Variable erstellen

Klicken Sie auf Neue Variable.
Geben Sie einen Variablennamen ein — das ist der Name, den Sie in Ihren Prüfungen referenzieren (zum Beispiel BASE_URL oder API_TOKEN).
Geben Sie einen Variablenwert ein.
Klicken Sie auf Variable speichern.

Sowohl der Name als auch der Wert sind erforderlich — eine Variable mit leerem Namen oder Wert kann nicht gespeichert werden.

Eine Variable bearbeiten oder löschen

Verwenden Sie die Zeilenaktionen auf der Variablen-Seite, um den Wert einer Variable zu aktualisieren oder sie zu entfernen. Eine Wertänderung wird beim nächsten Lauf jeder Prüfung wirksam, die sie referenziert.

Eine Variable in einer Prüfung referenzieren

Referenzieren Sie eine Variable, indem Sie ihren Namen in doppelte geschweifte Klammern setzen: {{VARIABLENNAME}}. LoadFocus ersetzt beim Ausführen der Prüfung den aktuellen Wert der Variable.

Einige Beispiele:

URL: https://{{BASE_URL}}/v1/users/{{USER_ID}}
Header: Authorization: Bearer {{API_TOKEN}}
Query-Parameter: ?account={{ACCOUNT_ID}}
Body: { "email": "{{TEST_EMAIL}}" }

Variablen vs. Secrets

Verwenden Sie Variablen für nicht-sensible, wiederverwendbare Werte wie Basis-URLs, Konto-IDs oder Feature-Flags — ihre Werte werden in der Variablenliste angezeigt.

Verwenden Sie Secrets für sensible Werte wie API-Tokens, Passwörter und Signierschlüssel. Secrets sind in der Oberfläche nur schreibbar: Einmal gespeichert, werden ihre Werte maskiert und nie wieder angezeigt. Referenzieren Sie ein Secret genauso wie eine Variable, mit {{SECRET_NAME}}.

Tipp: Ist ein Wert sensibel, speichern Sie ihn als Secret statt als Variable, damit er nicht in der Liste sichtbar ist.