Utvecklare → Email
Hantera e-posten för era domäner med kod: brevlådor på betald e-posthosting, kostnadsfri vidarebefordran för domäner registrerade hos NameOcean och inkommande e-post som skickas till er app som JSON.
Skapa en API-nyckel med email:read, och email:write för att göra ändringar. Alla endpoints finns i API-referensen och i OpenAPI-filen. Köp, uppgradering och förnyelse av en e-postplan dras från kontots kredit och görs i kontrollpanelen.
En maildomäns plan har ett lagringsutrymme som delas av dess brevlådor. Skapar ni en brevlåda utan lösenord genereras ett; svaret är det enda tillfälle då API:t returnerar det.
$ 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} | Brevlådor, alias, listor och IMAP/SMTP-inställningar |
| PATCH /email/domains/{domain}/mailboxes/{username} | Ändra namn eller kvot |
| POST /email/domains/{domain}/mailboxes/{username}/password | Ange ett lösenord eller generera ett |
| POST /email/domains/{domain}/aliases | Leverera en annan adress till en brevlåda |
| POST /email/domains/{domain}/lists | En e-postlista med domänens brevlådor |
| GET /email/domains/{domain}/dns-check | NS, MX, SPF, DKIM och DMARC, i realtid, med förväntade värden |
Domäner registrerade hos NameOcean som använder våra namnservrar kan vidarebefordra sin e-post kostnadsfritt. När ni aktiverar det skrivs MX-posten; om zonen har en annan leverantörs MX-poster, skicka replace_mx: true för att ta bort dem.
$ 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"}'
En ny måladress får ett mail med en länk och en 6-siffrig kod, och e-post vidarebefordras när ägaren har bekräftat (via länken, eller POST /email/forwarding/targets/{id}/verify med koden). * vidarebefordrar alla adresser som saknar eget alias. GET /email/forwarding/{domain}/messages listar de senaste 30 dagarnas e-post med status; kvarhållen e-post (skräppost, över dagsgränsen) kan vidarebefordras med /release.
I stället för vidarebefordran kan en adress skicka varje mail den tar emot till er HTTPS-endpoint som JSON: innehåll, headers och bilagor i base64. Funktionen öppnas efter en kort granskning av vad ni ska använda den till; fråga på en domäns sida för e-postvidarebefordran.
$ 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
}
Signaturen fungerar som för kontots webhooks: se verifiera en signatur.
Kontots webhooks kan prenumerera på email.*: email.mailbox.created, email.mailbox.deleted, email.forwarding.enabled och email.forwarding.disabled (skickas även när en domän inte längre uppfyller kraven för kostnadsfri vidarebefordran, med orsaken).
$ 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
Alla kommandon accepterar --json. Installation och alla kommandon: CLI.
Via MCP kan en assistent lista era e-postdomäner, kontrollera deras DNS, skapa brevlådor och alias samt aktivera vidarebefordran. Lösenord till brevlådor skickas aldrig till AI:n: ni läser dem i kontrollpanelen.