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

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

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

Метод GetSuppressedDestination

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

Возвращает информацию об адресе в пользовательском стоп-листе. Нужное облако определяется по сервисному аккаунту, от имени которого выполняется запрос.

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

GET /v2/email/suppression/addresses/{EmailAddress} HTTP/2

Path-параметрыPath-параметры

Параметр

Описание

EmailAddress

Тип: string.

Адрес получателя. Должен быть в процентном кодировании, например user%40example.com.

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

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

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

200 OK200 OK

{
   "SuppressedDestination": {
      "EmailAddress": "user@example.com",
      "Reason": "BOUNCE",
      "LastUpdateTime": 1586552585.000,
      "Attributes": {
         "MessageId": "0000018f-..."
      }
   }
}

Параметр

Описание

EmailAddress

Тип: string.

Адрес получателя.

Reason

Тип: string.

Причина добавления адреса в стоп-лист: BOUNCE или COMPLAINT.

LastUpdateTime

Тип: number.

Время последнего изменения записи в секундах в формате Unix.

Attributes

Тип: object.

Возвращается, только если адрес попал в стоп-лист автоматически. Содержит поле MessageId — идентификатор письма, из-за которого адрес попал в стоп-лист. Для адресов, добавленных вручную, объект отсутствует.

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

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

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

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

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

Код ошибки

Описание

400 BadRequestException

В запросе указан пустой или некорректный адрес.

403

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

404 NotFoundException

Адреса нет в стоп-листе.

429 TooManyRequestsException

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

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

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