Postman is a cross-platform application that includes tools you can use to both test API calls and confirm their results, which can save you time and frustration when building custom scripts that need access to Acquia’s APIs.
For a full list of Acquia’s public APIs for its products, see Platform APIs.
To install Postman on your local computer, download the application from www.getpostman.com/downloads.
After installing Postman, you must generate a Cloud Platform API access token.
To create a new Postman request:
Open Postman, and in the top, left corner, click New.
Scroll to Building Blocks, and then click Request to display the Save Request window.
In Request name, enter a human-readable name for your request.
(Optional) In the Request description field, enter a description that will help you identify the request in the future.
Use one of the following methods to add your request to a collection:
For more information about collections, see Creating collections.
Click Save.
After you create the request, you must authorize it.
The Cloud Platform API requires an access token to be sent with every API request.
For help generating a Cloud Platform API access token, see Generating an API token.
To send an access token with your requests:
Open Postman.
In the left column, click Collection, and then click the collection to display the requests it contains.
Click a request to select it. Postman displays information about the request.
In the menu, click Authorization.
In the Type list, click OAuth 2.0.
In the Add authorization data to list, click Request Headers.
Click Get New Access Token to display a Get New Access Token window.
https://accounts.acquia.com/api/auth/oauth/token
.Click Request Token to display the Manage Access Tokens window.
In the Token Name field, enter a human-readable name for your token.
Scroll to the bottom of the window, and then click Use Token.
You now have an authorization token you can use when making Cloud Platform API requests. For the process to regenerate the token when it expires, see Regenerating an access token.
After generating an authentication token in Postman, you can use the token to communicate with Cloud Platform API endpoints. To initiate a call to the Cloud Platform API through Postman:
Open Postman.
In the left column, click Collections, and then click the collection to display the requests it contains.
Click a request to select it. Postman displays information about the request.
In the list of Cloud Platform API endpoints, identify the endpoint you want to access.
In the Method list, click the method of the endpoint (such as
GET
or POST
) you want to access.
In the Enter Request URL field, paste in the full URL of the endpoint.
Cloud Platform API endpoints begin with the string
https://cloud.acquia.com/api
. Most contain placeholders inside curly
braces, such as {applicationUuid}
, which you must replace with live
data from your application.
Click Send to have Postman send your request. In the following example, the endpoint URL contains placeholder data:
In the menu, click Headers, and then in the sub-menu, click Body.
Postman displays the body section of your request in JSON format.
Access tokens are temporary and will expire. If, after sending an API request, Postman displays a response message similar to the following in the Headers section, your access token has expired and must be regenerated:
{
"error": "unauthorized",
"message": "The access token has expired."
}
To regenerate your access token in Postman:
Postman generates a new access token for your use.
Postman provides the Postman Console to help you with debugging your requests. To display the console, click the console icon at the bottom left of the Postman interface, as shown in this example:
For more information about the Postman Console, see Debugging and logs at the Postman Learning Center.