Маршруты Mailjet API и SMTP могут приводить к разным итоговым сообщениям, даже если видимый черновик совпадает. Сравнивайте сформированный MIME-контент, идентификаторы отправителя и доступные ссылки на сообщение перед интерпретацией Inbox Placement. Успешный ответ API или принятие SMTP не определяют папку, выбранную почтовым ящиком получателя.
Определите эквивалентные входные данные сообщения
Выберите не конфиденциальное сообщение приложения и сохраните его тему, отправителя, Reply-To, HTML и текстовую части, ссылки и поведение вложений. Используйте одинаковые тестовые данные для обоих маршрутов. Решите, сравниваете ли вы две передачи уже сформированного сообщения или две полные реализации приложения.
Это важно, поскольку путь API с шаблоном может формировать сообщение иначе, чем SMTP-библиотека, которая строит собственный MIME. Если приложение использует разные механизмы рендеринга, эксперимент включает эти механизмы. Не представляйте это как сравнение только транспорта, если не подтверждена идентичность контента.
Определите версию и контекст аккаунта
Зафиксируйте версию API и контекст аккаунта Mailjet или API-ключа, используемые каждым маршрутом, без записи секретов. Текущий пример первого письма Mailjet использует Send API v3.1, отдельная документация охватывает v3.0. Не смешивайте имена свойств из разных версий при исследовании проблемы с полезной нагрузкой.
Обзор SMTP возлагает ответственность за заголовки, обработку MIME и персонализацию на отправляющее приложение. Проверьте фактический вывод SMTP-библиотеки, не предполагая, что API и SMTP автоматически формируют одинаковую текстовую альтернативу или кодировку. Сохраните репрезентативные сгенерированные сообщения для содержательного сравнения.
Контролируйте скрытые различия
Сравните видимые From и конвертные идентификаторы, кодировку темы, имена вложений, текстовые и HTML-альтернативы, а также обязательные заголовки отписки для данного типа сообщения. Учтите опции отслеживания или шаблонов, которые могут применяться по-разному. Общий URL назначения не гарантирует одинаковое поведение переписывания ссылок.
Используйте одинаковую проверенную конфигурацию отправителя, где это поддерживается. Проверьте фактическую аутентификацию в полученных копиях; успешный вход или авторизация API лишь подтверждают доступ к сервису отправки. Это не доказывает прохождение аутентификации на стороне получателя или попадание в Inbox.
Отправляйте ограниченные оригинальные сообщения
Создайте LDM-тесты для выбранного отправителя и получите актуальных получателей каждого запуска. Отправьте один явно идентифицированный тест через соответствующую реализацию API и другой через SMTP, сохраняя сопоставимый состав получателей и время наблюдения. Используйте реальную логику приложения, если именно она является предметом проверки.
Сохраняйте идентификаторы ответов API и ссылки транзакций SMTP вместе с идентификаторами задач вашего приложения. Не записывайте секреты API, пароли SMTP или полные заголовки авторизации. Разграничивайте попытку запроса, успешную отправку провайдеру и последующее событие доставки.
Держите тестовых получателей вне регулярных заданий и обычных списков подписчиков. Прекращайте ограниченный рабочий процесс после запланированных сообщений. В этом руководстве не выполняются запросы и не отправляются письма, а также не предполагается нативное соединение Mailjet с LDM.
Согласуйте передачу и наблюдение
Для каждой полученной копии зафиксируйте её маршрут, ссылку на сообщение, папку и время наблюдения. Если путь API наблюдается, а SMTP отсутствует, сначала проверьте доказательства отправки и очереди SMTP. Отсутствие одного из них само по себе не означает, что получатель классифицировал SMTP-сообщение как Spam.
Если оба сообщения пришли, но размещение отличается, сравните их итоговый контент и заголовки перед утверждением, что протокол сам по себе объясняет результат. Небольшая контрольная панель не может универсально ранжировать API и SMTP. Поведение приложения, маршрутизация, история отправителя и контекст получателя остаются важными ограничениями.
Часто задаваемые вопросы
Успешный ответ API означает доставку в Inbox?
Нет. Это данные о передаче. Для последующих уровней используйте события отправки и фактическое наблюдение почтового ящика.
Можно ли сравнивать шаблон API с другим SMTP-черновиком?
Да, как сравнение двух полных конфигураций. Не приписывайте разницу исключительно API или SMTP без контроля контента.
Стоит ли выводить учетные данные при отладке?
Нет. Метки аккаунта, очищенная структура запроса, временные метки и ссылки на сообщения без секретов дают полезные данные без раскрытия аутентификационных материалов.
Официальные ссылки
Обновлено 2026-11-05; не заявляется эталон протокола.