Postman offers a lot of really nice features that make organizing or working with HTTP requests really nice. The application is broken into two main sections. On the left is a search field, as well as the ability to look at your request history and to store requests in collections. The rest of the application is dedicated to the compiling and sending of requests.

Creating request in Postman is a fairly straightforward process. For HTTP requests in general, we need to know the type of request we are going to make, the URL we are targetting, and the parameters required. Since each request is different, it is recommended that you reference the API documentation to ensure that you have the necessary information.

Note: Before you can make any requests against the API, you must first request an access token. Please see Requesting an Access Token for more information.

Once you know the kind of request you want to make, begin by specifying the type of request by selecting it from the drop down.

Next, enter in the API URL into the URL field. This should be in the format like "https://api.demdex.com/v1/traits/".

The final step is to define the request parameters. This is done by entering in various values on either the "Headers" or "Body" tabs.

The Headers change slightly depending on the request being sent, but generally they contain the following three items:

Accept | application/json

Authorization | Bearer <access token>

Content-Type | applicaiton/json

The Body also changes depending on both the type of request being sent, as well as what URL (or endpoint) we are targetting. Generally values are supplied in a JSON formatted block that contain the various data pairs.

With other requests, the values will be supplied in parameters instead.

Once everything has been setup for the request, you can either send it by clicking the "Send" button in the top right, or save it to a collection by clicking the disk button.

Requesting an Access Token:

The first API call we need to make is to request an Access Token. To do so, we will submit a POST request to "https://api.demdex.com/oauth/token". As part of the post, we need to define several headers and other parameters.

Here are some additional examples to help you get started with using the API.

Creating a Trait:

HTTP Request Type: Post

URL: https://api.demdex.com/v1/traits/

Headers:

Accept: application/json

Authorization: Bearer <access token>

Content-Type: application/json

Request Body:

When creating a new
trait, we need to define both the structure and type of trait, as well as the rules the trait will follow. Some of the required values include the trait type, trait name, trait description, trait rule, data source id, and the parent folder id. For more information https://marketing.adobe.com/resources/help/en_US/aam/c_methods.html.