Développeurs → Email
Gérez la messagerie de vos domaines depuis votre code : boîtes mail sur l'hébergement e-mail payant, redirection gratuite pour les domaines enregistrés chez NameOcean et e-mails entrants transmis à votre application en JSON.
Créez une clé API avec email:read, ainsi que email:write pour effectuer des modifications. Tous les endpoints figurent dans la référence de l'API et le fichier OpenAPI. L'achat, la mise à niveau et le renouvellement d'une offre e-mail utilisent le crédit du compte et se font depuis le tableau de bord.
L'offre d'un domaine de messagerie comprend un espace de stockage partagé entre ses boîtes mail. Si vous créez une boîte mail sans mot de passe, un mot de passe est généré ; la réponse est la seule fois où l'API le renvoie.
$ 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} | Boîtes mail, alias, listes et paramètres IMAP/SMTP |
| PATCH /email/domains/{domain}/mailboxes/{username} | Modifier le nom ou le quota |
| POST /email/domains/{domain}/mailboxes/{username}/password | Définir un mot de passe ou en générer un |
| POST /email/domains/{domain}/aliases | Distribuer une autre adresse dans une boîte mail |
| POST /email/domains/{domain}/lists | Une liste de diffusion des boîtes mail du domaine |
| GET /email/domains/{domain}/dns-check | NS, MX, SPF, DKIM et DMARC, en temps réel, avec les valeurs attendues |
Les domaines enregistrés chez NameOcean qui utilisent nos serveurs de noms peuvent rediriger leurs e-mails gratuitement. L'activation crée l'enregistrement MX ; si la zone contient des enregistrements MX d'un autre fournisseur, envoyez replace_mx: true pour les supprimer.
$ 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"}'
Une nouvelle adresse cible reçoit un e-mail contenant un lien et un code à 6 chiffres, et les e-mails sont redirigés dès que son propriétaire confirme (via le lien ou POST /email/forwarding/targets/{id}/verify avec le code). * redirige toutes les adresses qui n'ont pas leur propre alias. GET /email/forwarding/{domain}/messages liste les e-mails des 30 derniers jours avec leur statut ; les e-mails retenus (spam, limite quotidienne dépassée) peuvent être redirigés avec /release.
Au lieu d'une redirection, une adresse peut transmettre chaque e-mail reçu à votre endpoint HTTPS en JSON : corps, en-têtes et pièces jointes en base64. Cette fonctionnalité est accessible après un bref examen de l'usage que vous comptez en faire ; faites-en la demande sur la page Redirection d'e-mails d'un domaine.
$ 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 signature fonctionne comme pour les webhooks du compte : consultez vérifier une signature.
Les webhooks du compte peuvent s'abonner à email.* : email.mailbox.created, email.mailbox.deleted, email.forwarding.enabled et email.forwarding.disabled (également envoyé, avec le motif, lorsqu'un domaine ne remplit plus les conditions de la redirection gratuite).
$ 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
Chaque commande accepte --json. Installation et liste des commandes : CLI.
Via MCP, un assistant peut lister vos domaines de messagerie, vérifier leur DNS, créer des boîtes mail et des alias, et activer le transfert. Les mots de passe des boîtes mail ne sont jamais transmis à l'IA : vous les consultez dans le tableau de bord.