[Документация Yandex Cloud](../../index.md) > [Yandex Cloud Postbox](../index.md) > Справочник API > Как пользоваться API

# Как пользоваться API Amazon для работы с Yandex Cloud Postbox

## Подготовка к работе {#before-you-begin}

1. [Создайте сервисный аккаунт](../../iam/operations/sa/create.md).
1. [Назначьте сервисному аккаунту необходимые роли](../../iam/operations/sa/assign-role-for-sa.md).

   Подходящую роль можно выбрать из раздела [Управление доступом](../security/index.md#service-roles). Например, чтобы получить информацию о [конфигурации](../concepts/glossary.md#configuration), достаточно роли `postbox.viewer`. Чтобы отправлять письма, назначьте сервисному аккаунту роль `postbox.sender`.

1. [Создайте статический ключ доступа](../../iam/operations/authentication/manage-access-keys.md#create-access-key).

   Он нужен для аутентификации при отправке запросов к API Amazon. Чтобы хранить ключ безопасно, воспользуйтесь сервисом [Yandex Lockbox](../../lockbox/tutorials/static-key-in-lockbox/index.md).

## Общий вид запроса к API {#common-request-form}

```text
<HTTP-метод> <эндпоинт> HTTP/2
Host: postbox.cloud.yandex.net
{Authorization|X-YaCloud-SubjectToken}: <данные_для_аутентификации>
X-Amz-Date: <время_в_формате_ISO_8601>

<тело_запроса>
```

Список эндпоинтов и нужных для них HTTP-методов смотрите в [Справочнике API](api-ref/index.md), список доступных заголовков — в разделе [Заголовки запросов](api-ref/request-headers.md).

В запросе нужно передать один из заголовков для аутентификации:

* `X-YaCloud-SubjectToken` — содержит IAM-токен сервисного аккаунта. Подробнее об [аутентификации через IAM-токен](../api-ref/authentication.md).
* `Authorization` — содержит статический ключ доступа и подпись запроса. Она нужна, если вы используете API напрямую, без [AWS CLI](../tools/aws-cli.md) и приложений. Yandex Cloud Postbox поддерживает подпись [Amazon Signature Version 4](https://docs.amazonaws.cn/en_us/IAM/latest/UserGuide/reference_aws-signing.html). Подробнее в [описании заголовка](signing-requests.md#authorization-header) `Authorization`.

   Отрабатывать создание подписи вы можете с помощью AWS CLI в режиме отладки. Для этого к команде `aws` добавляйте флаг `--debug`. Подробнее в [примере отладки](signing-requests.md#debugging).

   Чтобы не составлять подпись вручную, вы можете использовать утилиту [cURL](https://curl.se/) — она автоматически подписывает запросы к API Amazon. Подробнее в [примере использования API](#ses-api-example).