Postman in Adobe Experience Platform
Postman is a collaboration platform for API development that allows you to set up environments with preset variables, share API collections, streamline CRUD requests, and more. Most Platform API services have Postman collections which can be used to assist with making API calls.
How to set up a Postman environment for Experience Platform
The following video guide outlines creating and setting up your Postman environment. A Postman environment contains all the required headers you need to make API calls to the various collections provided below. Once set up, any time a value expires (such as an ACCESS_TOKEN
) you can update the current value in the environment, and this new value is used across all your collections.
Postman collections collections
A folder containing all the available Postman collections can be found by, visiting the Experience Platform Postman samples GitHub repository. Alternatively, a Postman collection link can be found in each individual swagger file in the API reference documentation on Adobe I/O.
To download a Postman collection, select Raw from the GitHub page to load the raw JSON file in a new tab. Then, right-click and select Save as to save the file to a local destination of your choice.
Import a Postman collection import
In order to utilize a Postman collection, you need to have an environment set up. Once you have completed your environment setup, select the Manage Environments selector in the top-right corner.
A popover appears and displays all of your current environments. To import a collection, select import .
You are asked to choose a file to import. Select the Postman collection file you wish to import. Once selected, the collection populates in the left rail under the Collections tab.
Each collection has different key-value pairs that may be required to perform a successful CRUD operation. Please review the service’s API developer guide to learn about required values, tips, and see examples.
To learn more about the Postman UI and its available features, visit the Postman documentation.
Generate an access token with Postman for non-production use
The video below uses the Identity Management Service (IMS) Postman collection which can be downloaded from the public GitHub repository.
Next steps
This document introduced Postman environments, collections, and how to import collections. Now that you have Postman ready, visit the Platform getting started guide for information on required headers, examples, and a list of API guides available for each Platform service.