Почта

Аккаунты, домены, DNS, оплата ящиков, настройки, лимиты отправки и API-ключи. Начните с руководства по подключению почты.

📄️Интеграция почты

Подключение домена, покупка ящиков и управление почтой через Cloud API.

Доступные тарифы хранения и конечные месячные цены в USD. Наценка интеграции не добавляется. Передавайте активный code как plan_code при покупке или увеличении объёма ящика. Срок — один календарный месяц; объём можно только увеличивать. Письма, вложения и файлы используют общий объём хранилища. mail_quota_mb и file_quota_mb обозначают один лимит, а не два отдельных объёма.

📄️Почтовые аккаунты

Все аккаунты клиентов интеграции. Выбирать пользователя не требуется. До создания первого аккаунта возвращается пустой массив. Пароли не возвращаются.

📄️Создать почтовый аккаунт

Бесплатно создаёт аккаунт клиента с вашим api_user_id. Повтор с теми же api_user_id и name возвращает существующий аккаунт без пароля; другие данные вызывают 409. С полученными логином и паролем можно войти на adapt-mail.com. Сохраните пароль из ответа; для замены используйте password-reset. Почтовый ящик этим запросом не создаётся.

📄️Детали почтового аккаунта

Возвращает аккаунт этой интеграции, включая логин и api_user_id. Пароль не возвращается.

📄️Изменить почтовый аккаунт

Изменяет имя, доступ к аккаунту или пароль. Пропущенные поля и null не изменяют значения. Отключение аккаунта блокирует доступ, но не меняет оплаченные сроки. Изменение пароля или отключение отзывает сессии аккаунта.

📄️Сбросить пароль аккаунта

Создаёт новый пароль аккаунта и отзывает его сессии. Новый пароль возвращается только в этом ответе. Пароли отдельных ящиков не меняются.

📄️Вход в почту по ссылке

Создаёт одноразовую ссылку входа в Adapt Mail на 5 минут. Без mailbox_id или с null открывает весь аккаунт; с mailbox_id — только этот ящик выбранного аккаунта. locale задаёт язык интерфейса, по умолчанию en. Откройте login_url целиком, включая #token. Не сохраняйте и не кешируйте ссылку; после использования или истечения срока создайте новую. Пароли и существующие входы в браузере не меняются. При входе повторно проверяются владелец и доступ; смена пароля аккаунта делает ссылку недействительной.

📄️Домены интеграции

Все неудалённые домены клиентов интеграции, начиная с новых, с account_id и api_user_id. Выбирать аккаунт не требуется. Общие домены в этот список не входят.

📄️Домены аккаунта

Возвращает собственные домены клиента и доступные общие домены. Для создания ящика используйте ID активного домена.

📄️Подключить домен

Регистрирует домен со статусом pending. Передавайте полное доменное имя, например example.com, без http://, https://, пути или порта. Добавьте записи из маршрута DNS, затем вызовите verify. Уже подключённый домен возвращает 409.

📄️Удалить домен

Удаляет собственный домен только после удаления всех его ящиков, включая создаваемые, заблокированные и удаляемые. Общий домен удалить нельзя. Если удаление не подтверждено, повторите запрос; на удаляемом домене нельзя создавать ящики. Записи у вашего DNS-провайдера автоматически не удаляются.

📄️DNS-записи домена

Возвращает требуемые DNS-записи и найденные значения. name — имя записи, value — полное ожидаемое значение, matches — результат сравнения. Для MX разделите value на приоритет и сервер: «10 mx1.adapt-mail.com» означает приоритет 10 и сервер mx1.adapt-mail.com. В записи может быть error=dns_unavailable. GET проверяет записи, но не активирует домен. DKIM появляется после подтверждения. Порядок настройки описан в руководстве по почте.

📄️Подтвердить домен

Проверяет TXT владения и активирует домен. Если подтверждающий TXT не найден, возвращается 409. Ответ содержит DNS-записи, включая созданный TXT DKIM. Добавьте DKIM и повторно проверьте DNS. status=active подтверждает активацию, а не совпадение всех записей: проверяйте records[].matches.

📄️Почтовые ящики

Список ящиков интеграции без удалённых, начиная с новых. api_user_id — необязательный точный фильтр клиента. total_count — количество по фильтру до пагинации. Лимиты отправки и расход включены в этот же ответ.

📄️Купить почтовый ящик

Покупает ящик на один календарный месяц за баланс интеграции по цене каталога. api_user_id определяется аккаунтом account_id; domain_id должен быть активен и доступен аккаунту. Адрес формируется как local_part@домен. Используйте цену тарифа: отдельного расчёта покупки нет. Оплаченный срок начинается после завершения создания. HTTP 202 означает принятие заказа; проверяйте GET /orders/{order_id} до completed, затем получите ящик по mailbox_id. По умолчанию auto_renew=false.

📄️Детали почтового ящика

Возвращает ящик, расход хранилища, доступ, оплаченный срок, настройку автопродления, лимиты отправки и расход. Все даты в UTC. paid_until=null означает, что оплаченный период ещё не подтверждён.

📄️Рассчитать продление ящика

Продлевает на один календарный месяц по актуальной цене тарифа объёма ящика. Новый срок начинается с более поздней даты: paid_until или текущего времени. Продление доступно до начала удаления и в течение 24 часов после окончания оплаты. Ручная блокировка доступа не снимается. Возвращает цену и баланс без списания и создания заказа.

📄️Продлить почтовый ящик

📄️Рассчитать увеличение объёма

Увеличивает объём до большего активного тарифа. Ящик должен быть активен и оплачен. Доплата равна разнице актуальных месячных цен, умноженной на остаток каждого оплаченного календарного месяца, с округлением до четырёх знаков. paid_until не меняется. Уменьшение объёма не поддерживается. Возвращает доплату без списания.

📄️Увеличить объём ящика

📄️Удалить почтовый ящик

Создаёт бесплатный асинхронный заказ удаления. Удаляются ящик, письма и файлы. Неиспользованный оплаченный срок не возвращается. HTTP 202 подтверждает принятие, а не завершение удаления; проверяйте заказ и вебхук mailbox.deleted.

📄️Изменить настройки ящика

Асинхронно меняет имя, пароль ящика или подпись. Пропущенные поля и null не меняют значения; пустая строка очищает подпись. HTTP 200 возвращает операцию, а не завершённое изменение. Проверяйте её UUID через маршрут операций аккаунта. Логин и пароль аккаунта, объём и оплаченный срок не меняются.

📄️Автопродление ящика

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

📄️Доступ к ящику

Устанавливает ручной флаг enabled. Отключение не приостанавливает оплату и не меняет срок. Включение не восстанавливает просроченный или удаляемый ящик и не отменяет блокировку аккаунта. Возвращает данные ящика без счётчиков расхода отправки.

📄️Сменить владельца ящика

Переносит ящик в другой аккаунт той же интеграции и обновляет api_user_id. Адрес, пароль, содержимое и оплаченный срок сохраняются. Возвращает данные ящика без счётчиков расхода отправки.

📄️Почтовая операция

Возвращает операцию аккаунта. UUID приходит в ответе изменения настроек или как mail_operation_id в оплаченном заказе. queued/running — ожидание или выполнение; succeeded — успех; failed — ошибка; uncertain — результат не подтверждён; cancelled — отмена. result содержит только публичные поля результата. error — публичный код или null. Операция отправки не является заказом оплаты, принятие не подтверждает доставку.

📄️Повторить почтовую операцию

Повторяет допустимую неуспешную операцию настройки без нового списания. Отправку писем через этот маршрут повторить нельзя. Устаревшая настройка не может перезаписать более новую. Из оплаченных заказов можно возобновить только увеличение объёма в review; повтором остальных заказов сервис управляет автоматически. Недопустимая операция возвращает 409. После принятия проверяйте операцию и связанный заказ.

📄️Почтовые API-ключи

Список активных и отозванных почтовых ключей интеграции. Возвращаются только метаданные; активный ключ можно посмотреть через GET /mail/api-keys/{key_id}.

📄️Создать почтовый API-ключ

Почтовые ключи нужны для чтения и отправки писем, работы с папками и вложениями через почтовое API — например, в собственном интерфейсе почты или автоматизации. Они относятся к интеграции, а не к одному ящику. Создание услуг, оплата и продление используют ключ Cloud-интеграции. Для входа на adapt-mail.com нужны логин и пароль.

📄️Посмотреть почтовый API-ключ

Возвращает активный ключ полностью для просмотра или копирования. Отсутствующий, чужой или отозванный ключ возвращает 404. Если значение невозможно восстановить, возвращается 409 mail_key_not_recoverable; создайте новый ключ. Ответ содержит Cache-Control: no-store.

📄️Отозвать или удалить почтовый API-ключ

При permanent=false (по умолчанию) отзывает ключ и возвращает revoked=true. Ключ больше не авторизует запросы почтового API. При permanent=true окончательно удаляет отозванный ключ и возвращает deleted=true. Сначала отзовите активный ключ: попытка сразу удалить его вернёт 409 mail_key_active.