Postman Toolkit - Get Started

Abstract

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.

Overview

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.

postman 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

import workspace

Step 5. Set up the DSP Environment

In this series of steps, we will create a Postman Environment and configure the environment with your client_id and client_secret.

If you haven’t generated your client secret and ID, follow the steps outlined in this section in the DSP Authentication Guide.

  1. Click the eye icon next to the No Environment dropdown and then click the Add link within the Environment section.

add link
  1. Name the Environment DSP and fill in the table out with these values.

name environment

Note

The expires_at current value is hard-coded and needs to be “1604262592611”.

fill fields

Select Save in the top right.

  1. Activate the new environment we created by setting the Postman Environment from No Environment to DSP in the top right.

no environment

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:

  1. Select DSP API > Seats > GET Seats.

  2. Click Send.

Note

You may have to click Send twice if you initially get an error.

  1. Check the Status of your call.

  2. Check the Results of your call.

test configuration

Pre-request Script

Both the Trafficking and Reporting Collections contain a Pre-request script that runs before every API call.

The Pre-request script is code written in JavaScript following the process described in the DSP Authentication section of the documentation to generate the required access token.

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.

Common Issues

Make sure that you save your configuration when updating your client_id and client_secret.