Variablen ermöglichen es Ihnen, einem Wert einen Namen zu geben und ihn überall dort wiederzuverwenden, wo Sie ihn benötigen.
Zum Beispiel, anstatt einen sich häufig ändernden API-Token in jede Anfrage einzufügen, definieren Sie eine Variable wie ACCESS_TOKEN und verwenden Sie {{ACCESS_TOKEN}} in Ihren Anfragen. Wenn der Token abläuft, aktualisieren Sie die Variable einmal, und alle Anfragen, die sie verwenden, übernehmen automatisch den neuen Wert.
Variablentypen auf einen Blick
Apidog unterstützt verschiedene Variablentypen, die jeweils für spezifische Szenarien konzipiert sind. Sie können verwenden: globale Variablen auf Teamebene, globale Variablen auf Projektebene, Modulvariablen, Umgebungsvariablen, Testdatenvariablen und lokale Variablen.
Globale Variablen
Globale Variablen ermöglichen es Ihnen, Daten weitreichend zu teilen. Es gibt zwei Arten:
Globale Variablen auf Projektebene: Beschränkt auf das aktuelle Projekt. Perfekt zum Übergeben von Daten zwischen Anfragen im selben Projekt. Speichern Sie zum Beispiel einen Token vom Login-Endpunkt als globale Variable auf Projektebene und verwenden Sie ihn dann in anderen Anfragen innerhalb dieses Projekts wieder.
Globale Variablen auf Teamebene: Werden teamübergreifend in allen Projekten geteilt. Ideal für die projektübergreifende Zusammenarbeit. Wenn beispielsweise ein Authentifizierungsdienst einen Token ausstellt, der von mehreren Projekten verwendet wird, speichern Sie ihn als globale Teamvariable.
Hinweis zu Berechtigungen: Reguläre Mitglieder können nur die aktuellen Werte bestehender globaler Variablen auf Teamebene anzeigen und ändern. Sie können keine Variablen hinzufügen/löschen oder umbenennen. Nur Team-Admins können Variablen auf Teamebene vollständig unter Team-Ressourcen → Variablen verwalten.
Modulvariablen
Modulvariablen sind auf ein bestimmtes Modul beschränkt. Wenn Sie eine Postman Collection importieren, werden deren Collection-Variablen als Apidog-Modulvariablen importiert.
Sie eignen sich hervorragend für modulspezifische Konfigurationen. Zum Beispiel könnte ein Projekt separate Module für Benutzer, Bestellungen und Produkte haben – jedes kann seine eigene Konfiguration in Modulvariablen speichern.
Stellen Sie sicher, dass Apidog auf dem neuesten Stand ist, um Modulvariablen verwenden zu können.
Umgebungsvariablen
Umgebungsvariablen sind wahrscheinlich Ihr am häufigsten verwendeter Typ. Sie ermöglichen es Ihnen, zwischen Umgebungen zu wechseln, ohne die Konfiguration für jede Anfrage ändern zu müssen.
In der Praxis haben Sie normalerweise mehrere Umgebungen (lokal, Test, Staging, Produktion). Jede hat unterschiedliche Serveradressen, Datenbankverbindungen oder Konfigurationen von Drittanbietern. Mit Umgebungsvariablen können Sie sofort zwischen ihnen wechseln.
Hinweis: Es kann immer nur eine Umgebung aktiv sein. Wenn Sie eine Umgebung auswählen, werden alle darin definierten Variablen wirksam.
Testdatenvariablen
Testdatenvariablen ermöglichen datengesteuertes Testen. Wenn Sie denselben Endpunkt mit vielen Datensätzen testen müssen, ist dies Ihr Freund.
Bereiten Sie eine CSV- oder JSON-Datei mit mehreren Zeilen (oder Objekten) vor. In einem automatisierten Testszenario importieren Sie die Datei, und Apidog iteriert jede Zeile als einen Variablensatz und führt den Test für jede aus.
Lokale Variablen
Lokale Variablen haben die kürzeste Lebensdauer – sie sind nur während einer einzelnen Anfrage oder eines Testlaufs gültig. Sie verschwinden nach der Ausführung.
Da lokale Variablen die höchste Priorität haben, eignen sie sich perfekt, um andere Variablentypen vorübergehend zu überschreiben. Zum Beispiel definiert Ihre Umgebung user_id, aber für einen speziellen Test benötigen Sie einen anderen Wert – setzen Sie stattdessen eine lokale Variable mit demselben Namen, anstatt die Umgebung zu ändern.
Variablenpriorität
Wenn mehrere Variablen denselben Namen haben, löst Apidog sie nach Priorität auf (höchste zu niedrigster): Lokale Variablen > Testdatenvariablen > Umgebungsvariablen > Modulvariablen > Globale Variablen auf Projektebene > Globale Variablen auf Teamebene
Beispiel: Wenn Sie drei Variablen mit dem Namen userId definieren:
- Globale Variablen auf Projektebene:
userId = 1000 - Modulvariablen:
userId = 2000 - Umgebungsvariablen:
userId = 3000
Wenn Sie {{userId}} in einer Anfrage verwenden, ist der effektive Wert 3000 (aus der Umgebung). Wenn kein Umgebungswert vorhanden ist, wird auf den Modulwert (2000) zurückgegriffen, dann auf den globalen Projektwert (1000).
Initialwerte vs. Aktuelle Werte
Globale Variablen, Modulvariablen und Umgebungsvariablen haben sowohl Initialwerte als auch aktuelle Werte – dies gleicht die Teamfreigabe mit der persönlichen Privatsphäre aus.
- Initialwerte befinden sich auf den Servern von Apidog und werden mit Teamkollegen synchronisiert. Verwenden Sie sie für gemeinsame Konfigurationen, wie Testserver-URLs und öffentliche API-Schlüssel.
- Aktuelle Werte befinden sich nur auf Ihrem Gerät. Verwenden Sie sie für Geheimnisse wie persönliche API-Schlüssel, Passwörter oder private Umgebungseinstellungen.
Wenn ein aktueller Wert existiert, bevorzugt Apidog diesen. Wenn der aktuelle Wert leer ist, verwendet Apidog den Initialwert. Möchten Sie, dass der aktuelle Wert dem Initialwert folgt? Klicken Sie auf das Link-Symbol neben dem aktuellen Wert, um ihn neu zu binden.
Aktuelle Werte werden auf Ihrem Gerät gespeichert und können verloren gehen, wenn Sie den Cache leeren oder das Gerät wechseln. In der Apidog-Webversion werden sie im Browser gespeichert. Um auf ein neues Gerät zu wechseln, exportieren/importieren Sie Umgebungen, um die aktuellen Werte zu migrieren.
Hinweis: Beim Ausführen automatisierter Tests mit der Apidog CLI ist ein wesentlicher Unterschied zu beachten: Der Apidog-Client verwendet während der Ausführung aktuelle Werte, während die CLI die Initialwerte verwendet. Wenn die Ergebnisse zwischen dem Client und der CLI abweichen, ist dies ein häufiger Grund.
Möglichkeiten zum Festlegen von Variablen
Wählen Sie die Methode, die am besten dazu passt, woher der Wert stammt und wie Sie ihn verwenden werden.
Variablen direkt auf der Seite zur Umgebungsverwaltung festlegen
Die einfachste Methode. Klicken Sie auf die Schaltfläche Umgebungsverwaltung (oben rechts), wechseln Sie zu einer globalen oder spezifischen Umgebung und fügen Sie dann Namen und Werte hinzu.
Diese Methode eignet sich hervorragend für stabile Konfigurationen wie Datenbankverbindungen. Sie können sowohl Initialwerte (geteilt) als auch aktuelle Werte (privat) festlegen.
Die Funktion "Variable speichern" verwenden
Oft kommt der Variablenwert aus einer Antwort – wie ein Token von einem Login-Endpunkt oder eine Benutzer-ID von einem Create-User-Endpunkt. Verwenden Sie die visuelle Funktion "Variable speichern" in Post-Processoren, um eine neue Variable einzurichten.
Fügen Sie in den Post-Processoren einer Anfrage "Variable speichern" hinzu, wählen Sie die Quelle (üblicherweise die JSON-Antwort) und wählen Sie das Feld mithilfe von JSONPath aus.
Wenn die JSON-Antwort beispielsweise lautet:
{
"user": {
"id": "69",
"email": "Ralph85@gmail.com",
"first_name": "Katlynn",
"last_name": "Reichert",
"api_token": "dolore ut mollit Duis sit",
"created_at": "2025-09-19T01:03:50.236Z",
"updated_at": "2025-05-10",
"deleted_at": "2025-09-18T18:30:51.217Z",
"role": "developer",
"metadata": {}
}
}Verwenden Sie $.user.email, um den Token zu extrahieren.
Sie können Variablen auch direkt aus dem Antwortbereich einer Anfrage festlegen.
Variablen über Skripte festlegen
Für komplexere Logik verwenden Sie benutzerdefinierte Skripte in Pre-Processoren oder Post-Processoren. Apidog bietet eine vollständige Skript-API zur Manipulation aller Variablentypen.
// Eine globale Variable auf Projektebene festlegen
pm.globals.set('variable_key', 'variable_value');
// Eine globale Variable auf Teamebene festlegen (muss zuerst auf der Seite Team-Ressourcen definiert werden)
pm.globals.set('variable_key', 'variable_value', 'TEAM');
// Eine Umgebungsvariable festlegen
pm.environment.set('variable_key', 'variable_value');
// Eine Modulvariable festlegen
pm.moduleVariables.set('variable_key', 'variable_value');
// Eine lokale Variable festlegen
pm.variables.set('variable_key', 'variable_value');Beim Speichern von Objekten oder Arrays sollten Sie diese zuerst in einen String umwandeln und beim Lesen parsen. Zum Beispiel:
pm.environment.set('user', JSON.stringify(userObj));
const users = JSON.parse(pm.environment.get('user'));Hinweis: Skripte können nur die aktuellen Werte der Variablen festlegen. Initialwerte sollten auf der Seite zur Umgebungsverwaltung festgelegt werden.
Datenbankdaten als Variablen verwenden
Apidog kann Daten direkt aus einer Datenbank abrufen und als Variablen festlegen – ideal für Tests, die auf echten Datensätzen basieren.
Fügen Sie eine Datenbankoperation in Post-Processoren hinzu, konfigurieren Sie die Verbindung und schreiben Sie die SQL-Abfrage. Extrahieren Sie dann Felder mithilfe von JSONPath in Variablen.
Tipps zur Verwendung von Variablen
Wo Variablen funktionieren
Variablen werden nur aufgelöst, wenn eine Anfrage tatsächlich gesendet wird. Das bedeutet, Sie können sie in Headern, Parametern, im Body, in Testszenarien und Skripten verwenden – überall dort, wo sie am Senden einer Anfrage beteiligt sind.
Da Apidog visuell orientiert ist, gilt eine einfache Faustregel: Wenn Sie eine Schaltfläche "Dynamischer Wert" sehen, können Sie dort Variablen verwenden.
Grundlegende Syntax
Verwenden Sie doppelte geschweifte Klammern, um eine Variable zu referenzieren: {{variableName}}. Dies funktioniert in URL, Headern, Parametern und im Body.
Zum Beispiel in Parametern:
Und im Body:
Hinweise für JSON-Bodies: String-Variablen benötigen Anführungszeichen, numerische Variablen nicht. Doppelte geschweifte Klammern können JSON-Lint-Warnungen auslösen, diese können jedoch bedenkenlos ignoriert werden.
Wenn Sie "unresolved variable" sehen, geraten Sie nicht in Panik. Variablen, die in Post-Processoren oder Skripten festgelegt wurden, existieren möglicherweise erst, wenn die Anfrage ausgeführt wird, und lokale Variablen verschwinden nach der Ausführung. Der beste Weg zur Bestätigung ist, die Anfrage tatsächlich zu senden.
Untergeordnete Felder aus einer Variable abrufen
Manchmal speichern Ihre Variablen Objekte oder Arrays, nicht nur Strings oder Zahlen. Zum Beispiel gibt eine Benutzer-API oft ein Objekt mit ID, Name, E-Mail usw. zurück.
Angenommen, Sie haben dieses Antwortobjekt als Variable namens user gespeichert:
{
"id": 1001,
"name": "Joe",
"email": "joe@example.com",
"role": "admin"
}Sie können spezifische Felder mit der Punktnotation referenzieren, wie {{user.id}} (1001) oder {{user.name}} ("Joe").
Für Arrays ist es ähnlich. Wenn Sie eine Variable users haben:
[
{"id": 1001, "name": "Joe"},
{"id": 1002, "name": "Rio"},
{"id": 1003, "name": "Outher"}
]Verwenden Sie {{users[0].name}}, um den Namen des ersten Benutzers zu erhalten, oder {{users[1].id}} für die ID des zweiten Benutzers.
Dies folgt JSONPath-ähnlicher Semantik – der Variablenname verhält sich wie das Root ($).
Variablen in Skripten verwenden
Sie können Variablen in den benutzerdefinierten Skripten von Pre-Processoren oder Post-Processoren verwenden. Apidog bietet einen vollständigen Satz von Skript-APIs, die Ihnen den flexiblen Zugriff auf verschiedene Variablentypen ermöglichen.
// Eine globale Variable auf Projektebene abrufen
pm.globals.get('variable_key');
// Eine globale Variable auf Teamebene abrufen
pm.globals.get('variable_key', 'TEAM');
// Eine Umgebungsvariable abrufen
pm.environment.get('variable_key');
// Eine Modulvariable abrufen
pm.moduleVariables.get('variable_key');
// Eine lokale Variable abrufen
pm.variables.get('variable_key');Für Objekte/Arrays, die als Strings gespeichert sind, zuerst parsen:
const userObj = JSON.parse(pm.environment.get('user'));
console.log(userObj.name);Datengesteuertes Testen mit Testdatenvariablen
Laden Sie eine CSV- oder JSON-Datei mit mehreren Datenzeilen hoch. Während der Ausführung ersetzt Apidog {{variableName}} durch die Werte aus jeder Zeile und führt den Test einmal pro Zeile aus – perfekt zur Validierung der Robustheit mit vielen Eingaben.
Dynamische Wertausdrücke
Neben Ihren eigenen Variablen unterstützt Apidog dynamische Werte, die zufällige Daten nach spezifischen Regeln generieren.
In Skripten können Sie Strings, die dynamische Ausdrücke enthalten, mit await pm.variables.replaceInAsync() verarbeiten:
const template = "Hello, {{$person.fullName}}";
const result = await pm.variables.replaceInAsync(template);
console.log(result); // Gibt einen zufällig generierten Namen aus
Dynamische Werte eignen sich hervorragend, um zufällige Testdaten zu generieren, ohne im Voraus einen Datensatz vorbereiten zu müssen.
Zusammenfassung
Variablen sind eine der leistungsstärksten Funktionen in Apidog. Sie reduzieren Wiederholungen, machen Tests flexibel und vereinfachen den Wechsel zwischen Projekten und Umgebungen. Egal, ob Sie globale Einstellungen teamübergreifend teilen, Tests mit CSV-Daten steuern oder Werte lokal überschreiben, Variablen helfen, Ihren Workflow effizient und organisiert zu halten. Indem Sie Variablentypen, Prioritäten und deren Festlegung beherrschen, können Sie sicherstellen, dass Ihre API-Anfragen konsistent, wartbar und bereit für reale Szenarien bleiben.