Yandex Cloud
КейсыДокументация
ПрезентацияСвязаться с намиНачать бесплатно
Создавайте контент и получайте гранты!Готовы написать своё руководство? Участвуйте в контент-программе и получайте гранты на работу с облачными сервисами!
Подробнее о программе
Сделано на Gravity UI
Проект Яндекса
© 2026 ООО «Яндекс.Облако»
Yandex Cloud Postbox
  • Начало работы
  • Управление доступом
  • Правила тарификации
    • Аутентификация в API
    • Как пользоваться API
    • Подписывание запросов
      • Все методы
      • Отправка писем
      • Массовая отправка писем
        • Метод ListSuppressedDestinations
        • Метод GetSuppressedDestination
        • Метод PutSuppressedDestination
        • Метод DeleteSuppressedDestination
      • Заголовки запросов
  • Метрики Monitoring
  • Аудитные логи Audit Trails
  • Публичные материалы
  • История изменений
  • Вопросы и ответы

В этой статье:

  • Запрос
  • Заголовки запроса
  • Тело запроса
  • Ответы
  • 200 OK
  • Ошибки
  1. Справочник API
  2. REST
  3. Стоп-лист
  4. Метод PutSuppressedDestination

Метод PutSuppressedDestination

Статья создана
Yandex Cloud
Обновлена 27 августа 2026 г.
Открыть в Markdown
  • Запрос
    • Заголовки запроса
    • Тело запроса
  • Ответы
    • 200 OK
    • Ошибки

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

ЗапросЗапрос

PUT /v2/email/suppression/addresses HTTP/2

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

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

Тело запросаТело запроса

{
   "EmailAddress": "user@example.com",
   "Reason": "BOUNCE|COMPLAINT"
}

Параметр

Описание

EmailAddress

Тип: string.

Адрес получателя, который нужно добавить в стоп-лист.

Reason

Тип: string.

Обязательный параметр. Причина добавления адреса в стоп-лист: BOUNCE или COMPLAINT.

Если адрес уже есть в стоп-листе, новая запись не создается: у текущей записи обновляются причина и время изменения, а время создания сохраняется.

ОтветыОтветы

200 OK200 OK

Ответ 200 OK возвращается в случае успешного выполнения запроса.

ОшибкиОшибки

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

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

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

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

Код ошибки

Описание

400 BadRequestException

В запросе указан пустой или некорректный адрес либо причина не указана или не равна BOUNCE или COMPLAINT.

403

Недостаточно прав для выполнения запроса.

429 TooManyRequestsException

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

Была ли статья полезна?

Предыдущая
Метод GetSuppressedDestination
Следующая
Метод DeleteSuppressedDestination
Создавайте контент и получайте гранты!Готовы написать своё руководство? Участвуйте в контент-программе и получайте гранты на работу с облачными сервисами!
Подробнее о программе
Сделано на Gravity UI
Проект Яндекса
© 2026 ООО «Яндекс.Облако»