Skip to content
Postman API Testing Tips

How To Use Variable In Postman Url

API Testing Blog

How to use variables in Postman URLs for API Testing

Postman is a powerful tool for API testing, and using variables in your URLs can significantly streamline your workflow. Variables allow you to dynamically change parts of your requests, making your tests more flexible and reusable. Let’s explore how to effectively utilize variables in your Postman URL.

1. Defining Variables

Before using variables in your URLs, you need to define them. This can be done in various ways:

a) Environment Variables

This is the most common approach if you need to share values across multiple requests or tests.

Step 1: Navigate to the “Environments” tab in Postman’s sidebar.

Step 2: Create a new environment or select an existing one.

Step 3: Click “Add” to define a new variable. Enter a variable name (e.g., “baseUrl”) and its corresponding value (e.g., “https://api.example.com/v1”).

b) Global Variables

Global variables are accessible across any workspace.

Step 1: Go to the “Globals” tab in the Postman sidebar.

Step 2: Click “Add” to create a new global variable. Define the variable name and value.

c) Collection Variables

Collection variables are scoped to a specific collection.

Step 1: Open the collection you want to work with.

Step 2: Click on the “Variables” tab within the collection.

Step 3: Add your variable with its corresponding value.

2. Using Variables in the URL

Once your variables are defined, you can use them in your Postman requests:

Step 1: Open a new request or edit an existing one.

Step 2: In the URL field, use the following syntax: {{variableName}}

Example:

{{baseUrl}}/users/{{userId}}

This example utilizes two variables. When running the request, Postman will replace {{baseUrl}} with the value of the “baseUrl” variable, and {{userId}} with the value of the “userId” variable.

3. Data Driven Testing with Variables

Variables are key for data-driven testing, allowing you to execute a single request with multiple data sets:

a) Using a CSV File

Step 1: Create a CSV file containing your data points. Step 2: Import the CSV file using the “Data” tab in your request. Step 3: Use the {{$variableName}} syntax to access the CSV column data.

Example:

userId,userName
1,JohnDoe
2,JaneSmith

Request URL:

{{baseUrl}}/users/{{$userId}}

This will run the request twice, once with userId = 1 and userName = JohnDoe, and another time with userId = 2 and userName = JaneSmith.

4. Dynamically Generating Variable Values

You can also use JavaScript code to dynamically generate variable values at runtime:

Step 1: Go to the “Tests” tab of your request. Step 2: Use JavaScript code to generate the desired variable value. Step 3: Set the variable using the pm.environment.set() (for environment variables), pm.globals.set() (for global variables), or pm.collectionVariables.set() (for collection variables) functions.

Example:

let randomId = Math.floor(Math.random() * 1000) + 1;
pm.environment.set("userId", randomId);

This code snippet will generate a random “userId” value and store it in the environment variable.

5. Variable Scopes and Prioritization

Understanding variable scopes is crucial:

  • Environment Variables take precedence over Global Variables
  • Global Variables take precedence over Collection Variables
  • Collection Variables take precedence over Request Variables

This prioritization ensures that the most specific variable value is used when running your request.

6. Best Practices

  • Use descriptive variable names that clearly indicate their purpose.
  • Keep your environments organized with separate environments for different stages (development, testing, production).
  • Leverage dynamic variable generation for testing various scenarios and data sets.

By mastering the use of variables in Postman URLs, you can significantly enhance the efficiency and flexibility of your API testing. You can create dynamic, reusable, and data-driven tests that effectively validate your API’s functionality across various scenarios.

API Testing Blog