Ответы SMTP
При отправке писем по протоколу SMTP Yandex Cloud Postbox возвращает ответы в формате SMTP: числовой код ответа, расширенный код состояния (enhanced status code) и текстовое пояснение. Для ответов с кодом 4xx или 5xx к тексту добавляется идентификатор запроса RequestID. Укажите его при обращении в поддержку.
550 5.4.1 identity not verified RequestID: <request-id>
Успешные ответы
|
Код |
Расширенный код |
Текст |
Значение |
|
|
|
|
Письмо принято и поставлено в очередь на отправку. |
Временные ошибки 4xx
Ответы с кодом 4xx означают, что запрос можно повторить позже.
|
Код |
Расширенный код |
Текст |
Причина |
Что делать |
|
|
|
|
Внутренняя ошибка сервиса или непредвиденная ошибка обработки. |
Повторите отправку позже. Если ошибка повторяется, обратитесь в поддержку с |
|
|
|
|
Истек тайм-аут ожидания тела письма или соединение было разорвано во время передачи данных. |
Проверьте сетевое соединение и тайм-ауты клиента, повторите отправку. |
|
|
|
|
Превышен лимит получателей на одно письмо. |
Разбейте отправку на несколько писем с меньшим числом получателей. |
|
|
— |
|
Превышена допустимая частота отправки ( |
Снизьте темп отправки и повторите запрос позже. |
Постоянные ошибки 5xx
Ответы с кодом 5xx означают, что запрос не будет выполнен без изменений. Повторять его в том же виде бессмысленно.
Аутентификация и авторизация
|
Код |
Расширенный код |
Текст |
Причина |
Что делать |
|
|
|
|
Логин или пароль не переданы либо учетные данные имеют неверный формат подписи или кодировки Base64. |
Проверьте имя пользователя и пароль SMTP. |
|
|
|
|
Не прошла проверка учетных данных: неверный IAM-токен, API-ключ или статический ключ. |
Проверьте актуальность и корректность учетных данных. |
|
|
|
|
Ошибка при проверке прав доступа. |
Повторите запрос позже. Если ошибка повторится, обратитесь в поддержку. |
|
|
|
|
Учетные данные корректны, но у сервисного аккаунта нет права на отправку писем. |
Назначьте сервисному аккаунту роль |
Порядок команд и TLS
|
Код |
Расширенный код |
Текст |
Причина |
Что делать |
|
|
|
|
Команда отправлена по незашифрованному соединению. |
Установите TLS-соединение (STARTTLS или SMTPS) перед аутентификацией и отправкой. |
|
|
|
|
Команда |
Выполните |
Отправитель и получатели
|
Код |
Расширенный код |
Текст |
Причина |
Что делать |
|
|
— |
|
Аутентифицированный клиент указал пустой адрес отправителя ( |
Укажите корректный адрес отправителя. |
|
|
|
|
Адрес отправителя не найден. |
Проверьте, что адрес отправителя создан в Yandex Cloud Postbox. |
|
|
|
|
Адрес отправителя не подтвержден. |
Завершите проверку владения доменом. |
|
|
|
|
Адрес отправителя заблокирован. |
Обратитесь в поддержку для выяснения причины блокировки. |
|
|
|
|
Отправитель не входит в список разрешенных для адреса. |
Используйте разрешенного отправителя или добавьте отправителя в список разрешенных. |
Квоты и размер сообщения
|
Код |
Расширенный код |
Текст |
Причина |
Что делать |
|
|
|
|
Исчерпана суточная квота на отправку. |
Дождитесь сброса квоты или запросите ее увеличение. |
|
|
|
|
Превышена квота на количество получателей. |
Уменьшите число получателей или запросите увеличение квоты. |
|
|
|
|
Превышена квота на размер письма. |
Уменьшите размер письма: тело письма или вложения. |
|
|
|
|
Размер письма превышает технический лимит сервера. |
Уменьшите размер письма. |
Синтаксис и валидация
|
Код |
Расширенный код |
Текст |
Причина |
Что делать |
|
|
— |
|
Слишком длинная строка команды. |
Проверьте формат SMTP-команд и сократите строки с учетом ограничения длины строки в RFC 2822. |
|
|
— |
|
Запрос не прошел валидацию. |
Исправьте письмо согласно тексту ошибки. |
|
|
— |
|
Не удалось разобрать адрес в команде |
Проверьте корректность адресов отправителя и получателей. |
Идентификатор запроса
Если ответ содержит RequestID: <request-id>, сохраните этот идентификатор и приложите его при обращении в поддержку: он ускорит диагностику.