# Postman

Postman is a free tool for conveniently working with APIs in a GUI. It is available for Windows, macOS, and Linux. For the installation instructions, refer to [<mark style="color:blue;">Postman Documentation</mark>](https://www.postman.com/).

## Configuration

1\. Log in to Postman using your credentials.

2\. Select **AWS Signature** from the **Type** drop-down list in the **Authorization** tab for a request. Specify where Postman should append your authorization data using the **Add authorization data to** drop-down list.

* If you select **Request Headers**, Postman populates the **Headers** tab with **Authorization** and X-Amz- prefixed fields.
* If you select the **Request URL**, Postman populates the **Params** tab with authentication details prefixed with X-Amz-.

![Postman](https://1737632334-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MifAzdGvKLDTtvJP8sm%2Fuploads%2Fgit-blob-927969420e0e82104bbd63d1a807929a10059b1c%2Fpostman-api.png?alt=media\&token=048f83c9-e7fc-4a94-bc2c-32c5ce36bd9c)

{% hint style="info" %}
**Note:**

* The parameters listed below contain confidential information. We recommend using variables to secure this data while working collaboratively.
* To get the **Access Key** and **Secret Key**, see [<mark style="color:blue;">Generate a Key</mark>](https://docs.ionos.com/sections-test/guides/storage-and-backup/ionos-object-storage/get-started/generate-key).
* Advanced fields are optional, but Postman will attempt to generate them automatically if necessary.
  {% endhint %}

3\. For **AWS Region**, leave the field blank as the region from the endpoint will be used.

4\. For **Service Name**, enter `s3`. The name of the service that receives the requests.

5\. For **Session Token**, leave the field blank. It is only required when temporary security credentials are used.

{% hint style="success" %}
**Result:** The Postman configuration is complete.
{% endhint %}

{% hint style="info" %}
**Note:** Use the correct endpoint URL for each region. For information on the supported <code class="expression">space.vars.ionos\_cloud\_object\_storage</code> service endpoints, see [<mark style="color:blue;">Endpoints</mark>](https://docs.ionos.com/sections-test/guides/storage-and-backup/ionos-object-storage/endpoints) and [<mark style="color:blue;">API</mark>](https://api.ionos.com/docs/s3/v2/).
{% endhint %}