Dla programistów → Email
Zarządzaj pocztą swoich domen z poziomu kodu: skrzynki w płatnym hostingu poczty, bezpłatne przekierowanie dla domen zarejestrowanych w NameOcean oraz poczta przychodząca przesyłana do Twojej aplikacji jako JSON.
Utwórz klucz API z uprawnieniem email:read, a do wprowadzania zmian także email:write. Wszystkie endpointy znajdziesz w dokumentacji API i pliku OpenAPI. Zakup, zmiana i odnowienie planu pocztowego są opłacane ze środków na koncie i odbywają się w panelu.
Plan domeny pocztowej ma określoną przestrzeń dyskową, którą współdzielą jej skrzynki. Jeśli utworzysz skrzynkę bez hasła, zostanie ono wygenerowane; odpowiedź to jedyny moment, w którym API je zwraca.
$ 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} | Skrzynki, aliasy, listy i ustawienia IMAP/SMTP |
| PATCH /email/domains/{domain}/mailboxes/{username} | Zmiana nazwy lub limitu |
| POST /email/domains/{domain}/mailboxes/{username}/password | Ustawienie lub wygenerowanie hasła |
| POST /email/domains/{domain}/aliases | Dostarczanie innego adresu do skrzynki |
| POST /email/domains/{domain}/lists | Lista mailingowa skrzynek domeny |
| GET /email/domains/{domain}/dns-check | NS, MX, SPF, DKIM i DMARC na żywo, wraz z oczekiwanymi wartościami |
Domeny zarejestrowane w NameOcean, które korzystają z naszych serwerów nazw, mogą bezpłatnie przekierowywać pocztę. Włączenie tej funkcji zapisuje rekord MX; jeśli strefa zawiera rekordy MX innego dostawcy, wyślij replace_mx: true, aby je usunąć.
$ 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"}'
Na nowy adres docelowy wysyłana jest wiadomość z linkiem i 6-cyfrowym kodem, a poczta jest przekierowywana dopiero po potwierdzeniu przez właściciela (linkiem lub przez POST /email/forwarding/targets/{id}/verify z kodem). * przekierowuje każdy adres, który nie ma własnego aliasu. GET /email/forwarding/{domain}/messages zwraca pocztę z ostatnich 30 dni wraz ze statusem; wstrzymaną pocztę (spam, przekroczony limit dzienny) można przekierować za pomocą /release.
Zamiast przekierowywać, adres może wysyłać każdą otrzymaną wiadomość do Twojego endpointu HTTPS jako JSON: treść, nagłówki i załączniki w base64. Funkcja jest dostępna po krótkiej weryfikacji planowanego zastosowania; poproś o nią na stronie Przekierowanie poczty danej domeny.
$ 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
}
Podpis działa tak samo jak w webhookach konta: zobacz weryfikacja podpisu.
Webhooki konta mogą subskrybować zdarzenia email.*: email.mailbox.created, email.mailbox.deleted, email.forwarding.enabled i email.forwarding.disabled (wysyłane także wtedy, gdy domena przestaje spełniać warunki bezpłatnego przekierowania, wraz z przyczyną).
$ 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
Każde polecenie obsługuje --json. Instalacja i wszystkie polecenia: CLI.
Przez MCP asystent może wyświetlić listę Państwa domen pocztowych, sprawdzić ich DNS, utworzyć skrzynki pocztowe i aliasy oraz włączyć przekierowanie. Hasła do skrzynek nigdy nie są przekazywane AI: odczytują je Państwo w panelu.