Udviklere → Email

Email API

Administrer mailen for dine domæner fra kode: postkasser på betalt e-mailhosting, gratis videresendelse for domæner registreret hos NameOcean og indgående mail sendt til din app som JSON.

Før du går i gang

Opret en API-nøgle med email:read og email:write for at foretage ændringer. Alle endpoints findes i API-referencen og OpenAPI-filen. Køb, opgradering og fornyelse af en mailplan bruger kontokredit og foretages i kontrolpanelet.

Postkasser

Et maildomænes plan har en lagerstørrelse, som dets postkasser deler. Opretter du en postkasse uden adgangskode, genereres der en; svaret er den eneste gang, API'et returnerer den.

curl

$ 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}	Postkasser, aliasser, lister og IMAP/SMTP-indstillinger
PATCH /email/domains/{domain}/mailboxes/{username}	Skift navn eller kvote
POST /email/domains/{domain}/mailboxes/{username}/password	Angiv en adgangskode, eller generér en
POST /email/domains/{domain}/aliases	Lever en anden adresse til en postkasse
POST /email/domains/{domain}/lists	En mailingliste med domænets postkasser
GET /email/domains/{domain}/dns-check	NS, MX, SPF, DKIM og DMARC, live, med de forventede værdier

Gratis videresendelse

Domæner registreret hos NameOcean, der bruger vores navneservere, kan videresende deres mail gratis. Når det slås til, oprettes MX-posten; hvis zonen har en anden udbyders MX-poster, så send replace_mx: true for at fjerne dem.

curl

$ 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 modtageradresse får en mail med et link og en 6-cifret kode, og mail videresendes, når ejeren har bekræftet (via linket eller POST /email/forwarding/targets/{id}/verify med koden). * videresender alle adresser, der ikke har deres eget alias. GET /email/forwarding/{domain}/messages viser de seneste 30 dages mail med status; tilbageholdt mail (spam, over den daglige grænse) kan videresendes med /release.

Indgående mail til webhook

I stedet for videresendelse kan en adresse sende hver mail, den modtager, til dit HTTPS-endpoint som JSON: indhold, headers og vedhæftninger i base64. Funktionen åbnes efter en kort gennemgang af, hvad du vil bruge den til; spørg på et domænes side for e-mailvideresendelse.

curl

$ 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"}'

POST 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 fungerer som ved kontoens webhooks: se verificering af en signatur.

Hændelser

Kontoens webhooks kan abonnere på email.*: email.mailbox.created, email.mailbox.deleted, email.forwarding.enabled og email.forwarding.disabled (sendes også, når et domæne ikke længere opfylder betingelserne for gratis videresendelse, med årsagen).

Fra terminalen

nameocean

$ 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

Alle kommandoer understøtter --json. Installation og alle kommandoer: CLI.

Fra din AI

Via MCP kan en assistent vise Deres maildomæner, tjekke deres DNS, oprette postkasser og aliasser samt slå videresendelse til. Adgangskoder til postkasser sendes aldrig til AI'en: De ser dem i kontrolpanelet.