Resend-совместимые email API: чего совместимость не гарантирует

Что на самом деле означает совместимость API

For email developers, Resend-compatible mail APIs implement the same request and response schemas as the provider they replace. If you use a Resend-compatible API, you can change your base URL and API key in your environment variables and your POST /emails calls will still work. It covers the syntax of the payload, the HTTP status codes, and the structure of the JSON response. It does not cover your sender reputation, your DNS configuration, your IP warm up, or your billing structure.

Как инженер, отвечающий за очередь инцидентов, я видел команды, считавшие «совместимость» миграцией в один клик. Это не так. Вы переносите интерфейс, а не инфраструктуру.

Интерфейс: что покрывается

Когда провайдер заявляет о совместимости с Resend, он обычно повторяет основной эндпоинт отправки. Это позволяет отправлять полезную нагрузку такого вида:

{ "from": "onboarding@example.com", "to": "user@gmail.com", "subject": "Welcome to the App", "html": "<strong>Hello!</strong>" }

Если API совместим, сервер вернёт 200 OK или 201 Created с ID сообщения. Это «простая» часть. Она избавляет от необходимости переписывать логику интеграции или менять SDK. Для команд, создающих ИИ-агентов, такое постоянство жизненно важно. Когда агенты запускают отправку писем через MCP-сервер или карточку A2A, они полагаются на предсказуемые схемы, чтобы убедиться, что побочный эффект (отправка письма) действительно произошёл.

Инфраструктура: что НЕ покрывается

Совместимость заканчивается на уровне HTTP. Всё, что происходит после того, как API принял запрос, зависит от провайдера.

1. DNS и подтверждение домена

API-ключ не переносит авторизацию вашего домена. Нельзя просто сменить URL и ожидать, что письма будут проходить аутентификацию. Домен нужно заново подтвердить у нового провайдера. Для этого в DNS добавляются новые записи SPF, DKIM и DMARC.

Если забыть их обновить, письма, скорее всего, будут отклоняться или помечаться как спам, потому что новый провайдер не авторизован отправлять от вашего имени. Прежде чем переключаться, проверьте, что записи корректно распространились, с помощью Email DNS Checker от SendHQ.

2. Репутация отправителя и прогрев IP-адресов

Репутация привязана к IP-адресу отправки и к домену. Переходя от одного провайдера к другому, вы часто переходите на новый набор общих IP-адресов. Даже если у домена отличная репутация, новый IP может быть «холодным» или, что хуже, использоваться совместно с недобросовестным отправителем.

Приём провайдером (API отвечает «OK») — это не то же самое, что доставка (принимающий сервер принимает письмо), а доставка — не то же самое, что попадание во «Входящие» (письмо оказывается в основной папке). Совместимость покрывает приём провайдером. На доставку и попадание во «Входящие» она никак не влияет.

3. Вебхуки и схемы событий

Даже если API отправки совместим, события вебхуков (доставлено, отказ, жалоба) часто несовместимы. Если ваша система запускает последующую логику по событиям доставки, проверьте полезные нагрузки вебхуков нового провайдера. Событие bounce в одной системе может называться hard_bounce в другой.

Цена совместимости: реальные цены

Совместимость позволяет искать более выгодные цены без затрат на полное переписывание. Однако модели ценообразования сильно различаются. По данным на сентябрь 2026 года:

• Amazon SES: самые агрессивные цены. A la carte — 0.10 USD за 1 000 писем (цены Amazon SES). Новые тарифы, введённые 21 июля 2026 года: Essentials (0.16 USD за 1 000), Pro (0.22 USD за 1 000 плюс 105 USD в месяц за регион) и Enterprise (0.23 USD за 1 000 плюс 500 USD в месяц).
• Resend: бесплатный тариф на 3 000 писем в месяц (не более 100 в день). Тариф Pro — 20 USD в месяц за 50 000 писем, превышение — 0.90 USD за 1 000 (цены Resend).
• Postmark: 15 USD в месяц за 10 000 писем, превышение — от 1.80 до 1.20 USD за 1 000 (цены Postmark).
• Mailgun: 15 USD в месяц за 10 000 писем, превышение — от 1.80 до 1.10 USD за 1 000 (цены Mailgun).
• SendGrid: бесплатный тариф теперь — 60-дневный пробный период, Essentials — от 19.95 USD в месяц (цены SendGrid).

Для наглядности: отправка 50 000 писем стоит около 5 USD на SES a la carte, но около 66 USD на тарифах Postmark. Совместимость API делает такую оптимизацию затрат возможной без месяца инженерной работы.

Надёжность и агенты

Если вы относитесь к письму как к внешнему побочному эффекту, особенно при работе с ИИ-агентами, нужно учитывать сбои. Ответ API 200 OK не означает, что письмо дошло до пользователя.

Идемпотентность

Если агент повторяет запрос из-за тайм-аута, вы рискуете отправить одно и то же письмо дважды. Это плохой пользовательский опыт. Передавайте в заголовках ключ идемпотентности. Тогда при двойной отправке одного и того же запроса провайдер отправит только одно письмо.

Процессы подтверждения

У агентов не должно быть неограниченного доступа к вашей квоте отправки. Добавьте слой подтверждения для массовых отправок. Простой чек-лист для писем, отправляемых агентами:

1. Проверка схемы: соответствует ли полезная нагрузка спецификации совместимого API?
2. Ограничение частоты: не превышает ли агент дневной лимит (например, бесплатный лимит Resend в 100 писем в день)?
3. Идемпотентность: есть ли уникальный ключ у этой конкретной транзакции?
4. Участие человека: требует ли это письмо ручного согласования до вызова API?

Чек-лист миграции

Если вы переходите на провайдера, совместимого с Resend, соблюдайте эту последовательность, чтобы доставка не обрушилась:

• Настройка DNS: настройте SPF, DKIM и DMARC. Прочитайте наше руководство по аутентификации почты, чтобы убедиться, что вы не пропустили записи.
• Проверка: используйте инструмент, чтобы подтвердить распространение DNS.
• Прогрев: при больших объёмах постепенно переносите трафик от старого провайдера к новому. Не переносите 100% трафика за один час.
• Аудит вебхуков: сопоставьте типы событий нового провайдера со схемами вашей внутренней базы данных.
• Обработка ошибок: проверьте, как новый провайдер обрабатывает недействительные email-адреса. Возвращает ли он 400 или 202 с последующим событием отказа (bounce)?

Сводка компромиссов

Аспект | Покрывается совместимостью? | Что нужно сделать

Полезная нагрузка запроса | Да | Ничего (если спецификация совпадает)

Формат ответа | Да | Ничего (если спецификация совпадает)

Аутентификация домена | Нет | Обновить DNS-записи

Репутация IP | Нет | Период прогрева

Цены и квоты | Нет | Изучить страницы цен провайдера

События вебхуков | Нет | Обновить обработчики событий

Совместимость — инструмент гибкости, а не волшебная палочка для доставляемости. Разделяя интерфейс и инфраструктуру, вы можете оптимизировать стоимость и производительность, не привязываясь к экосистеме одного поставщика.

Email API с минимальным сбором данных, готовый к работе с агентами и упрощающий эту инфраструктуру, — SendHQ.