Tukipyynnöt, vastaukset ilmoituksiin, botille postitetut asiakirjat: verkkotunnuksesi osoitteeseen lähetetty posti saapuu HTTPS-päätepisteeseesi yhtenä allekirjoitettuna JSON POST -pyyntönä, joka sisältää tekstin, HTML:n ja kaikki liitteet. Ei postilaatikon kyselyä eikä IMAPia.
email:write.$ nameocean email forwards on example.com
Tämä ohjaa verkkotunnuksen MX-tietueen NameOceanin sähköpostin edelleenlähetyspalvelimille. Jos verkkotunnuksella on jo MX-tietueita muualla oleville postilaatikoille, komento pysähtyy ja luettelee ne: kaikki verkkotunnuksen posti siirtyisi tänne. Lisää --replace-mx vain, jos haluat juuri sitä.
Postin lähettäminen URL-osoitteeseen avataan tilikohtaisesti lyhyen tarkistuksen jälkeen, jotta roskapostin välittäjät pysyvät poissa. Pyydä sitä verkkotunnuksen sivulla kohdassa Hallintapaneeli → Sähköpostin edelleenlähetys ja kerro lyhyesti, mihin aiot käyttää sitä. Siihen asti API vastaa 403 not_approved.
$ nameocean email inbound add example.com support https://app.example.com/hooks/mail
$ 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": "support", "url": "https://app.example.com/hooks/mail"}'
Vastaus sisältää allekirjoitussalaisuuden (whsec_…); tallenna se sovelluksesi asetuksiin. localpart * lähettää kaikki verkkotunnuksen osoitteet, joilla ei ole omaa aliasta. Verkkotunnuksella voi olla enintään kolme tällaista webhookia.
Tarkista allekirjoitus käsittelemättömästä rungosta ja lue sitten JSON. Pieni Flask-vastaanotin:
import base64, hashlib, hmac, json, os, time
from flask import Flask, abort, request
app = Flask(__name__)
SECRET = os.environ["NAMEOCEAN_WEBHOOK_SECRET"] # whsec_...
def verified(header, body, tolerance=300):
fields = dict(part.split("=", 1) for part in header.split(",") if "=" in part)
ts = int(fields.get("t", "0"))
if abs(time.time() - ts) > tolerance:
return False
expected = hmac.new(SECRET.encode(), f"{ts}.".encode() + body, hashlib.sha256).hexdigest()
return hmac.compare_digest(expected, fields.get("v1", ""))
@app.post("/hooks/mail")
def mail():
body = request.get_data()
if not verified(request.headers.get("X-NameOcean-Signature", ""), body):
abort(401)
mail = json.loads(body)
print(mail["envelope"]["from"], "→", mail["envelope"]["to"], mail["subject"])
for a in mail["attachments"]:
data = base64.b64decode(a["content_base64"])
print(" attachment", a["filename"], a["content_type"], len(data), "bytes")
return "", 204 # any 2xx: delivered
X-NameOcean-Event: email.received
X-NameOcean-Delivery: 6f1c2a4e-8b3d-4f5a-9c7e-1d2b3a4c5e6f
X-NameOcean-Signature: t=1794300000,v1=5f2b…
{
"id": "6f1c2a4e-8b3d-4f5a-9c7e-1d2b3a4c5e6f",
"event": "email.received",
"received_at": "2026-11-11T09:30:12+00:00",
"envelope": {"from": "alice@example.org", "to": "support@example.com"},
"from": "Alice <alice@example.org>",
"to": "support@example.com",
"cc": null,
"reply_to": null,
"subject": "Order 1042",
"date": "Wed, 11 Nov 2026 09:30:05 +0000",
"message_id": "<…@example.org>",
"in_reply_to": null,
"references": null,
"text": "Hi…",
"html": "<p>Hi…</p>",
"headers": [["From", "Alice <alice@example.org>"], …],
"attachments": [{"filename": "invoice.pdf", "content_type": "application/pdf", "content_id": null,
"size": 48211, "content_base64": "JVBERi0…"}],
"spam_score": 0.4,
"size": 66120
}
id pysyy samana, kun viesti lähetetään uudelleen, joten käytä sitä kaksoiskappaleiden ohittamiseen. in_reply_to ja references kertovat, mihin omista viesteistäsi joku vastasi.
nameocean email forwards log example.com (tai GET /email/forwarding/example.com/messages) ja voit vapauttaa ne: viesti lähetetään vielä kerran samalla id:llä.