Связаться с намиПодключиться

Метод SendEmail

Статья создана
Обновлена 23 сентября 2024 г.

Отправляет электронное письмо с адреса в каталоге. Нужный каталог определяется по сервисному аккаунту, от имени которого выполняется запрос.

Альтернативный способ отправки почты — с помощью протокола SMTP.

Запрос

POST /v2/email/outbound-emails HTTP/2

Заголовки запроса

Используйте в запросе общие заголовки.

Тело запроса

{
  "FromEmailAddress": "<адрес_отправителя>",
  "FromEmailAddressIdentityArn": "<параметр_для_совместимости>",
  "Destination": {
    "ToAddresses": [
      "<адрес_получателя>"
    ],
    "CcAddresses": [
      "<адрес_получателя_копии>"
    ],
    "BccAddresses": [
      "<адрес_получателя_скрытой_копии>"
    ]
  },
  "Content": {
    "Simple": {
      "Subject": {
        "Data": "<текст_темы>",
        "Charset": "<кодировка>"
      },
      "Body": {
        "Text": {
          "Data": "<текст_письма>",
          "Charset": "<кодировка>"
        },
        "Html": {
          "Data": "<текст_письма>",
          "Charset": "<кодировка>"
        }
      }
    },
    "Raw": {
      "Data": "<все_содержимое_письма>"
    }
  }
}

Параметр

Описание

FromEmailAddress

Тип: string.

Адрес, с которого отправляется письмо. Он должен быть верифицирован.

FromEmailAddressIdentityArn

Тип: string.

Используется только для совместимости с AWS.

Destination

Тип: object.

Объект, который содержит параметры, описывающие письмо.

Simple

Тип: object.

Простой тип. Нельзя использовать вместе с Raw. Подходит, если нужно отправить письмо без дополнительных настроек. Такое письмо состоит из темы и содержимого. Тип: object.

Subject

Тип: object.

Описывает тему:

  • Data — текст темы. Тип: string.
  • Charset — кодировка. Тип: string. Возможные значения: UTF-8, ISO-8859-1, Shift_JIS.

Body

Тип: object.

Описывает содержимое:

  • Text — объект, отвечающий за отображение письма в почтовых клиентах, которые не поддерживают HTML. Тип: object.
    • Data — текст письма. Тип: string.
    • Charset — кодировка. Тип: string. Возможные значения: UTF-8, ISO-8859-1, Shift_JIS.
  • Html — объект, отвечающий за отображение письма в почтовых клиентах, которые поддерживают HTML. Тип: object.
    • Data — текст письма. Тип: string.
    • Charset — кодировка. Тип: string. Возможные значения: UTF-8, ISO-8859-1, Shift_JIS.

Raw

Тип: object.

Необработанный тип. Нельзя использовать вместе с Simple. Подходит, если нужно дополнительно настроить содержимое письма. К такому типу предъявляются требования:

  • Письмо должно состоять из заголовка и содержимого, разделенных пустой строкой.
  • В письме должны присутствовать все обязательные поля заголовков.
  • Все фрагменты MIME-письма должны быть корректно отформатированы.
  • Вложения должны быть в формате, который поддерживается сервисом Yandex Cloud Postbox.
  • В письме должна использоваться кодировка Base64.
  • Если в письме есть содержимое, которое выходит за пределы семиразрядного диапазона символов ASCII, его нужно закодировать, чтобы оно корректно отображалось в почтовом клиенте получателя.
  • Максимальная длина строки в письме — 1000 символов.

Письмо целиком размещается в параметре Data. Тип: string.

Ответы

200 OK

{
  "MessageId": "<идентификатор_письма>"
}

Параметр

Описание

MessageId

Тип: string.

Уникальный идентификатор письма.

Ошибки

Для всех ошибок тело ответа представлено в одинаковом формате:

{
   "Code": "<название_ошибки>",
   "message": "<пояснение_к_ошибке>"
}

Название ошибки заимствуется из ее кода, например BadRequestException.

Возможные ошибки:

Код ошибки

Описание

400 BadRequestException

В запросе неправильно указаны заголовки или параметры.

400 AccountSuspendedException

Для этого сервисного аккаунта возможность отправлять почту ограничена навсегда.

400 SendingPausedException

Для этого сервисного аккаунта возможность отправлять почту временно ограничена.

400 MessageRejected

Письмо содержит некорректные данные.

400 MailFromDomainNotVerifiedException

Адрес, с которого отправляется письмо, не верифицирован.

404 NotFoundException

Запрошенный ресурс не найден.

429 TooManyRequestsException

При вызове запроса превышена квота.

429 LimitExceededException

При вызове запроса превышен лимит.

См. также

Предыдущая
Все методы
Следующая
Метод ListDomainIdentities