Режим песочницы

Как тестировать отправку, не отправляя писем #

Прежде чем отправлять настоящие письма, интеграцию удобно проверить так, чтобы ничего не ушло реальным получателям. В Haskimail для этого есть три инструмента — они решают разные задачи, и их можно сочетать.

Сервер-песочница

Отдельный сервер, с которого письма не доставляются получателям. Во всём остальном он такой же, как живой: у него есть каналы отправки, API-токены и SMTP-реквизиты, шаблоны, вебхуки и статистика. Письма проходят все обычные проверки и видны в активности сервера как отправленные.

Подходит, чтобы проверить интеграцию целиком — через API или SMTP — например, в тестовом или staging-окружении.

Тестовые адреса для возвратов

Адреса на домене bounce-testing.haskimail.ru, которые имитируют жёсткий или мягкий возврат, блокировку почтовым сервером или жалобу на спам. Письмо на такой адрес никуда не уходит, а Haskimail сразу создаёт событие — такое же, как при настоящем возврате.

Подходит, чтобы проверить, как ваше приложение обрабатывает возвраты и вебхуки. Работает и на живом сервере, и на песочнице.

Тестовый токен HASKIMAIL_API_TEST

Передайте HASKIMAIL_API_TEST в заголовке X-Haskimail-Server-Token вместо токена сервера, и Haskimail проверит только сам запрос — обязательные поля, адреса, вложения — и вернёт ответ в том же формате, что и при отправке. Письмо при этом не создаётся вовсе: его не будет ни в статистике, ни в активности, вебхуки не сработают. Токен работает только для отправки писем через API. Подробнее — в разделе Аутентификация.

Подходит, чтобы проверить формирование запроса при разработке или в автотестах, когда аккаунт и сервер не нужны.

Если аккаунт на модерации #

Пока аккаунт проходит модерацию, письма можно отправлять только на подтверждённые адреса и адреса на подтверждённых доменах. На инструменты для тестирования это ограничение не распространяется — их письма никуда не уходят, поэтому пользоваться ими можно сразу после регистрации:

• с сервера-песочницы письма принимаются на любые адреса;
• на тестовые адреса bounce-testing.haskimail.ru можно отправлять с любого сервера — остальные получатели письма проверяются как обычно;
• тестовый токен HASKIMAIL_API_TEST работает без ограничений.

Остальные проверки действуют как обычно: например, адрес отправителя должен быть подтверждён.