Postman Toolkit - Get Started¶
Describes the steps you need to follow to install and configure the Postman toolkit for optimizing, testing and error-checking your Yahoo DSP API calls.
To test and verify the calls you make in the Yahoo DSP API, you may wish to set up the Postman HTTP client, which lets you make requests (GET, PUT, POST, and DELETE calls) to the DSP RESTful APIs.
Postman is a widely used tool for building and handling HTTP requests to REST-based services. It can be useful in your development efforts for optimizing, testing and error-checking your API calls when working with the programmatic Yahoo DSP API.
Follow the steps outlined in the sections below to get started.
Install and Configure Postman¶
You can install Postman as a Chrome, Windows, Linux or MacOS app. The best strategy for working with Postman is to get the desktop client. The Chrome version, however, will run on any platform and is identical in functionality and appearance.
Step 1. Install Postman¶
Begin by installing Postman at https://www.postman.com/downloads/
Once the download is complete, launch Postman.
Step 2. Create a new workspace¶
In the app, select Workspaces > Create Workspace.
In this document, we’ll use a Workspace called Yahoo Postman API Toolkit.
Step 3. Access the Yahoo DSP API collection¶
You can get access to the Yahoo DSP API collection by simply clicking the button and selecting which version of Postman you have. After that, Postman will automatically open and ask you to import the collection.
Step 4. Select the Workspace¶
Select the desired workplace and click the Import Button. After a few seconds your import is now complete.
Step 5. Set up the DSP Environment¶
In this series of steps, we will create a Postman Environment and configure the environment with your
If you haven’t generated your client secret and ID, follow the steps outlined in this section in the DSP Authentication Guide.
Click the eye icon next to the No Environment dropdown and then click the Add link within the Environment section.
Name the Environment DSP and fill in the table with these values.
The expires_at current value is hard-coded and needs to be “1604262592611”.
Select Save in the top right.
Activate the new environment we created by setting the Postman Environment from No Environment to DSP in the top right.
Step 6. Test your configuration¶
Your Yahoo DSP API Postman collection is now ready to use.
To test your configuration, make the Get Seats Call under the Traffic APIs:
Select DSP API > Seats > GET Seats.
You may have to click Send twice if you initially get an error.
Check the Status of your call.
Check the Results of your call.
Both the Trafficking and Reporting Collections contain a Pre-request script that runs before every API call.
Refer to the DSP Authentication Guide for more information.
The Pre-request script does not need to be altered for making calls from within Postman but may need to be recreated when building out your production solution.
Make sure that you save your configuration when updating your