Разработчици → 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, които използват нашите nameserver-и, могат да пренасочват пощата си безплатно. При включване се създава 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. Функцията се отключва след кратък преглед на това за какво ще я използвате; заявете я от страницата Email Forwarding на домейна.
$ 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, да създава пощенски кутии и псевдоними и да включва пренасочването. Паролите на пощенските кутии никога не се изпращат към AI: виждате ги в таблото за управление.