техническое · ответ с источниками
Что такое режим песочницы (sandbox mode) в SendGrid?
Режим песочницы SendGrid — ограниченная среда, в которой разработчики могут тестировать интеграции с API и настройки SMTP, не отправляя письма реальным получателям. В этом режиме система проверяет запрос и возвращает успешный ответ, но само письмо на адрес назначения не доставляется, чтобы во время разработки не рассылать спам случайно и не допустить злоупотреблений.
Как работает режим песочницы
Когда аккаунт находится в режиме песочницы, SendGrid обрабатывает входящий вызов API или SMTP-запрос, проверяя синтаксическую корректность полезной нагрузки и действительность аутентификации. API возвращает код состояния 202 Accepted, означающий, что запрос получен. Однако агент передачи почты не ретранслирует сообщение во внешний интернет. Это позволяет разработчикам проверить логику кода и обработку ошибок, не рискуя репутацией отправителя и не неся расходов.
Требования к верификации
Чтобы выйти из режима песочницы, пользователи должны пройти процедуру верификации. Обычно нужно указать данные аккаунта и подтвердить адрес отправителя. SendGrid требует этот шаг, чтобы снизить риск использования платформы в злонамеренных целях. Пока аккаунт не одобрен полностью, любые попытки отправить почту на неподтверждённые адреса приведут к тому, что сообщение будет отброшено, хотя API вернёт успешный ответ.
Стратегии тестирования
Разработчикам следует использовать режим песочницы для тестирования интеграции приложения с API SendGrid. Когда успешные ответы API подтверждены, следующий шаг — подтвердить отдельный email-адрес отправителя или весь домен. Бесплатные инструменты SendHQ помогут разработчикам убедиться, что DNS-записи настроены правильно, до перехода в продакшен, чтобы избежать ошибок доставки.
Переход в продакшен
Для перехода в продакшен нужно завершить активацию аккаунта и настроить аутентификацию домена. Для этого в настройки DNS домена отправки добавляются SPF- и DKIM-записи. Когда статус аккаунта сменится с sandbox на active, письма начнут доставляться реальным получателям. Перед запуском рассылки по всему списку пользователей разработчикам стоит провести финальный тест на известный внутренний адрес.
Что спрашивают команды
Почему я получаю ответ 202, а письма нет?
Так и должен работать режим песочницы. Статус 202 означает, что API-запрос корректен, но письмо не доставлено, поскольку аккаунт всё ещё ограничен.
Как отключить режим песочницы?
Нужно пройти процедуру верификации аккаунта и предоставить команде SendGrid запрошенные сведения о компании для одобрения.
Можно ли в режиме песочницы отправлять письма на собственный адрес?
Как правило, нет. Если email-адрес не подтверждён как отправитель и не входит в подтверждённую идентичность, режим песочницы блокирует доставку на все адреса.
Платен ли режим песочницы?
Нет, запросы в режиме песочницы не учитываются в месячной квоте отправки, так как письма фактически не доставляются.
Первоисточники
- Документация SendGrid — Twilio SendGrid
- Цены SendGrid — Twilio SendGrid