Edit in GitHubLog an issue

Getting Started with Postman

Postman is an HTTP API-focused development environment which many developers used to experiment with APIs similar to the Cloud Manager API.

If you use Postman, there is a Cloud Manager-specific collection which can be imported into your workspace using the button below.

Collection Variables#

This collection defines a number of variables which are used in the contained requests. In general, you do not need to modify these variables; if you copy the request definitions from this collection to another collection, you should be sure to set these variables.

  • host_name - The Cloud Manager API host name, cloudmanager.adobe.io.
  • ims_endpoint - The host name for the Adobe Identity Management System (IMS), ims-na1.adobelogin.com.
  • cloudmanager_claim - The access claim used in the JWT token, https://ims-na1.adobelogin.com/s/ent_cloudmgr_sdk.

Configuration#

The requests in this collection depend upon a set of Postman environment variables. After you click the button above, a new environment will be created named Cloud Manager Public API which has the necessary variables defined. First, select this environment from the environment drop-down list.

Postman Environment Drop Down

Then click on the eye icon to view the environment variables and click the Edit link to edit the variables.

Postman Environment Details

Four of these values need to be populated using the values displayed in the Adobe Developer Console.

  • api_key
  • organization_id
  • technical_account_id
  • client_secret

The private_key variable needs to be populated with the contents of the private.key file generated by Open SSL as described in the Adobe I/O JWT Documentation.

Obtaining the Access Token#

Once the environment variables are populated, open the Obtain Access Token request from the Cloud Manager Public API collection and click the Send button.

Send Access Token Request

This will automatically set the access_token environment variable with a token which is valid for 24 hours. If you need to refresh it, just re-send this request.

Executing Other Requests#

In addition to the Obtain Access Token request, the collection includes other requests which can be executed.

If you create your own requests in Postman, keep in mind that they must always include the Authorization, x-gw-ims-org-id, and x-api-key headers. The Authorization header will be automatically inherited for requests defined in the Cloud Manager Public API collection, but if you create your own requests outside of this collection, you will need to configure this header, using the access_token envrionment variable.

  • Privacy
  • Terms of Use
  • Do not sell my personal information
  • AdChoices
Copyright © 2022 Adobe. All rights reserved.