Email API

Ennen kuin aloitat

Luo API-avain, jolla on oikeus email:read, ja muutoksia varten email:write. Kaikki päätepisteet löytyvät API-dokumentaatiosta ja OpenAPI-tiedostosta. Sähköpostipaketin ostaminen, päivittäminen ja uusiminen käyttää tilin saldoa, ja ne tehdään hallintapaneelissa.

Postilaatikot

Sähköpostidomainin paketilla on tallennustila, jonka sen postilaatikot jakavat. Jos luot postilaatikon ilman salasanaa, salasana luodaan automaattisesti; API palauttaa sen vain tässä vastauksessa.

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

Ilmainen edelleenlähetys

NameOceanissa rekisteröidyt domainit, jotka käyttävät nimipalvelimiamme, voivat lähettää postinsa edelleen ilmaiseksi. Käyttöönotto kirjoittaa MX-tietueen; jos vyöhykkeellä on toisen palveluntarjoajan MX-tietueita, poista ne lähettämällä replace_mx: true.

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

Uuteen kohdeosoitteeseen lähetetään viesti, jossa on linkki ja 6-numeroinen koodi, ja posti lähetetään edelleen, kun omistaja vahvistaa osoitteen (linkillä tai koodilla kutsulla POST /email/forwarding/targets/{id}/verify). * lähettää edelleen kaikki osoitteet, joilla ei ole omaa aliasta. GET /email/forwarding/{domain}/messages listaa viimeisten 30 päivän postin tiloineen; pidätetty posti (roskaposti, päivärajan ylitys) voidaan lähettää edelleen kutsulla /release.

Saapuva posti webhookiin

Edelleenlähetyksen sijaan osoite voi lähettää jokaisen vastaanottamansa viestin HTTPS-päätepisteeseesi JSON-muodossa: sisällöt, otsakkeet ja liitteet base64-koodattuina. Ominaisuus avataan, kun käyttötarkoituksesi on lyhyesti tarkistettu; pyydä sitä domainin Sähköpostin edelleenlähetys -sivulla.

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

Allekirjoitus toimii samoin kuin tilin webhookeissa: katso allekirjoituksen tarkistaminen.

Tapahtumat

Tilin webhookit voivat tilata email.*-tapahtumia: email.mailbox.created, email.mailbox.deleted, email.forwarding.enabled ja email.forwarding.disabled (lähetetään myös syyn kera, kun domain ei enää täytä ilmaisen edelleenlähetyksen ehtoja).

Päätteestä

$ 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

Jokainen komento hyväksyy valitsimen --json. Asennus ja kaikki komennot: CLI.

Tekoälystäsi

MCP:n kautta avustaja voi listata sähköpostiverkkotunnuksenne, tarkistaa niiden DNS-asetukset, luoda postilaatikoita ja aliaksia sekä ottaa edelleenlähetyksen käyttöön. Postilaatikoiden salasanoja ei koskaan lähetetä tekoälylle: näette ne hallintapaneelissa.