Sviluppatori → Email
Gestisca la posta dei Suoi domini via codice: caselle di posta con l'hosting email a pagamento, inoltro gratuito per i domini registrati su NameOcean e posta in arrivo inviata alla Sua app in formato JSON.
Crei una chiave API con email:read, e email:write per apportare modifiche. Tutti gli endpoint sono nel riferimento API e nel file OpenAPI. L'acquisto, l'upgrade e il rinnovo di un piano email utilizzano il credito dell'account e si effettuano dalla dashboard.
Il piano di un dominio di posta prevede uno spazio di archiviazione condiviso dalle sue caselle. Se crea una casella senza password, ne viene generata una; la risposta è l'unica occasione in cui l'API la restituisce.
$ 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} | Caselle, alias, liste e impostazioni IMAP/SMTP |
| PATCH /email/domains/{domain}/mailboxes/{username} | Modificare nome o quota |
| POST /email/domains/{domain}/mailboxes/{username}/password | Impostare o generare una password |
| POST /email/domains/{domain}/aliases | Recapitare un altro indirizzo a una casella |
| POST /email/domains/{domain}/lists | Una mailing list delle caselle del dominio |
| GET /email/domains/{domain}/dns-check | NS, MX, SPF, DKIM e DMARC, in tempo reale, con i valori attesi |
I domini registrati su NameOcean che usano i nostri nameserver possono inoltrare la posta gratuitamente. Attivando l'inoltro viene scritto il record MX; se la zona contiene record MX di un altro provider, invii replace_mx: true per rimuoverli.
$ 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"}'
Un nuovo indirizzo di destinazione riceve un'email con un link e un codice a 6 cifre, e la posta viene inoltrata dopo la conferma del titolare (tramite il link oppure POST /email/forwarding/targets/{id}/verify con il codice). * inoltra ogni indirizzo che non ha un proprio alias. GET /email/forwarding/{domain}/messages elenca la posta degli ultimi 30 giorni con il relativo stato; la posta trattenuta (spam, oltre il limite giornaliero) può essere inoltrata con /release.
Anziché inoltrare, un indirizzo può inviare ogni email ricevuta al Suo endpoint HTTPS in formato JSON: corpo, intestazioni e allegati in base64. È disponibile dopo una breve verifica dell'uso previsto; ne faccia richiesta dalla pagina Inoltro email di un dominio.
$ 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
}
La firma funziona come per i webhook dell'account: consulti verifica di una firma.
I webhook dell'account possono sottoscrivere email.*: email.mailbox.created, email.mailbox.deleted, email.forwarding.enabled ed email.forwarding.disabled (inviato anche quando un dominio non soddisfa più i requisiti per l'inoltro gratuito, con il motivo).
$ 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
Ogni comando accetta --json. Installazione e tutti i comandi: CLI.
Tramite MCP un assistente può elencare i Suoi domini di posta, verificarne il DNS, creare caselle e alias e attivare l'inoltro. Le password delle caselle non vengono mai inviate all'IA: le può leggere nella dashboard.