# 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/cloud/backup-and-storage/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/cloud/backup-and-storage/ionos-object-storage/endpoints) and [<mark style="color:blue;">API</mark>](https://api.ionos.com/docs/s3/v2/).
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.ionos.com/cloud/backup-and-storage/ionos-object-storage/s3-tools/postman.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
