Разработчикам → Email
Управляйте почтой своих доменов из кода: почтовые ящики на платном почтовом хостинге, бесплатная переадресация для доменов, зарегистрированных в NameOcean, и входящая почта, отправляемая в Ваше приложение в формате JSON.
Создайте ключ API с правом email:read, а для внесения изменений — email:write. Все endpoint'ы описаны в справочнике API и в файле OpenAPI. Покупка, повышение и продление почтового тарифа списываются с баланса аккаунта и выполняются в панели управления.
Тариф почтового домена включает объём хранилища, общий для всех его почтовых ящиков. Если создать почтовый ящик без пароля, пароль будет сгенерирован автоматически; API возвращает его только один раз — в ответе на этот запрос.
$ curl -X POST https://nameocean.net/api/v1/email/domains/example.com/mailboxes \ -H "Authorization: Bearer $NAMEOCEAN_API_KEY" -H "Content-Type: application/json" \ -d '{"username": "info", "full_name": "Info", "quota_gb": 2}' {"address": "info@example.com", "username": "info", "full_name": "Info", "quota_gb": 2, "used_gb": "0.00", "aliases": [], "password": "Qm7…"}
| GET /email/domains/{domain} | Почтовые ящики, псевдонимы, списки рассылки и настройки IMAP/SMTP |
| PATCH /email/domains/{domain}/mailboxes/{username} | Изменить имя или квоту |
| POST /email/domains/{domain}/mailboxes/{username}/password | Установить или сгенерировать пароль |
| POST /email/domains/{domain}/aliases | Доставлять письма с другого адреса в почтовый ящик |
| POST /email/domains/{domain}/lists | Список рассылки из почтовых ящиков домена |
| GET /email/domains/{domain}/dns-check | NS, MX, SPF, DKIM и DMARC в реальном времени, с ожидаемыми значениями |
Домены, зарегистрированные в NameOcean и использующие наши серверы имён, могут бесплатно переадресовывать почту. При включении переадресации создаётся MX-запись; если в зоне есть MX-записи другого провайдера, передайте replace_mx: true, чтобы удалить их.
$ curl -X POST https://nameocean.net/api/v1/email/forwarding/example.com \ -H "Authorization: Bearer $NAMEOCEAN_API_KEY" $ curl -X POST https://nameocean.net/api/v1/email/forwarding/example.com/aliases \ -H "Authorization: Bearer $NAMEOCEAN_API_KEY" -H "Content-Type: application/json" \ -d '{"localpart": "hello", "to": "me@gmail.com"}'
На новый целевой адрес приходит письмо со ссылкой и 6-значным кодом, и почта начинает переадресовываться после того, как его владелец подтвердит адрес (по ссылке или через POST /email/forwarding/targets/{id}/verify с кодом). * переадресует все адреса, у которых нет собственного псевдонима. GET /email/forwarding/{domain}/messages возвращает список писем за последние 30 дней с их статусом; задержанные письма (спам, превышение суточного лимита) можно переадресовать через /release.
Вместо переадресации адрес может отправлять каждое полученное письмо на Ваш HTTPS endpoint в формате JSON: тело, заголовки и вложения в base64. Функция становится доступна после короткой проверки того, для чего Вы будете её использовать; запросите доступ на странице «Переадресация почты» нужного домена.
$ curl -X POST https://nameocean.net/api/v1/email/forwarding/example.com/webhooks \ -H "Authorization: Bearer $NAMEOCEAN_API_KEY" -H "Content-Type: application/json" \ -d '{"localpart": "inbound", "url": "https://example.com/hooks/mail"}'
X-NameOcean-Event: email.received
X-NameOcean-Signature: t=1794300000,v1=5f2b…
{
"id": "6f1c2a4e-8b3d-4f5a-9c7e-1d2b3a4c5e6f",
"event": "email.received",
"envelope": {"from": "alice@example.org", "to": "inbound@example.com"},
"from": "Alice <alice@example.org>",
"subject": "Order 1042",
"text": "Hi…",
"html": "<p>Hi…</p>",
"headers": [["From", "Alice <alice@example.org>"], …],
"attachments": [{"filename": "invoice.pdf", "content_type": "application/pdf", "size": 48211,
"content_base64": "JVBERi0…"}],
"spam_score": 0.4,
"size": 66120
}
Подпись работает так же, как у webhook'ов аккаунта: см. проверку подписи.
Webhook'и аккаунта можно подписать на события email.*: email.mailbox.created, email.mailbox.deleted, email.forwarding.enabled и email.forwarding.disabled (отправляется также, когда домен перестаёт соответствовать условиям бесплатной переадресации, с указанием причины).
$ nameocean email mailboxes add example.com info --name "Info" $ nameocean email aliases add example.com sales info $ nameocean email check example.com $ nameocean email forwards on example.com $ nameocean email forwards add example.com hello me@gmail.com $ nameocean email inbound add example.com support https://example.com/hooks/mail
Каждая команда поддерживает --json. Установка и все команды: CLI.
Через MCP ассистент может просматривать список Ваших почтовых доменов, проверять их DNS, создавать почтовые ящики и псевдонимы, а также включать переадресацию. Пароли почтовых ящиков никогда не передаются ИИ: Вы смотрите их в панели управления.