Метод GetSuppressedDestination
Возвращает информацию об адресе в пользовательском стоп-листе. Нужное облако определяется по сервисному аккаунту, от имени которого выполняется запрос.
Запрос
GET /v2/email/suppression/addresses/{EmailAddress} HTTP/2
Path-параметры
|
Параметр |
Описание |
|
|
Тип: string. Адрес получателя. Должен быть в процентном кодировании, например |
Заголовки запроса
Используйте в запросе общие заголовки.
Ответы
200 OK
{
"SuppressedDestination": {
"EmailAddress": "user@example.com",
"Reason": "BOUNCE",
"LastUpdateTime": 1586552585.000,
"Attributes": {
"MessageId": "0000018f-..."
}
}
}
|
Параметр |
Описание |
|
|
Тип: string. Адрес получателя. |
|
|
Тип: string. Причина добавления адреса в стоп-лист: |
|
|
Тип: number. Время последнего изменения записи в секундах в формате Unix. |
|
|
Тип: object. Возвращается, только если адрес попал в стоп-лист автоматически. Содержит поле |
Ошибки
Для всех ошибок тело ответа представлено в одинаковом формате:
{
"Code": "<название_ошибки>",
"message": "<пояснение_к_ошибке>"
}
Название ошибки заимствуется из ее кода, например BadRequestException.
Возможные ошибки:
|
Код ошибки |
Описание |
|
|
В запросе указан пустой или некорректный адрес. |
|
|
Недостаточно прав для выполнения запроса. |
|
|
Адреса нет в стоп-листе. |
|
|
При вызове запроса превышена квота. |