Fejlesztők → Email
Kezelje domainjei levelezését kódból: postafiókok fizetős levelezési tárhelyen, ingyenes továbbítás a NameOceannél regisztrált domainekhez, valamint az alkalmazásához JSON formátumban továbbított bejövő levelek.
Hozzon létre egy API-kulcsot email:read, módosításokhoz pedig email:write jogosultsággal. Minden végpont megtalálható az API-referenciában és az OpenAPI-fájlban. Levelezési csomag vásárlása, bővítése és megújítása fiókegyenleget használ, és az irányítópulton történik.
Egy levelezési domain csomagja meghatározott tárhelymérettel rendelkezik, amelyen a postafiókjai osztoznak. Ha jelszó nélkül hoz létre postafiókot, a rendszer generál egyet; az API csak ebben a válaszban adja vissza.
$ 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} | Postafiókok, aliasok, listák és az IMAP/SMTP beállítások |
| PATCH /email/domains/{domain}/mailboxes/{username} | Név vagy kvóta módosítása |
| POST /email/domains/{domain}/mailboxes/{username}/password | Jelszó beállítása vagy generálása |
| POST /email/domains/{domain}/aliases | Másik cím kézbesítése egy postafiókba |
| POST /email/domains/{domain}/lists | A domain postafiókjaiból álló levelezőlista |
| GET /email/domains/{domain}/dns-check | NS, MX, SPF, DKIM és DMARC élőben, a várt értékekkel |
A NameOceannél regisztrált, a mi névszervereinket használó domainek ingyenesen továbbíthatják leveleiket. A bekapcsolás létrehozza az MX rekordot; ha a zónában más szolgáltató MX rekordjai vannak, küldje el a replace_mx: true paramétert az eltávolításukhoz.
$ 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"}'
Egy új célcím egy linket és egy 6 jegyű kódot tartalmazó levelet kap, és a továbbítás akkor indul, amikor a tulajdonosa megerősíti (a linkkel, vagy a kóddal a POST /email/forwarding/targets/{id}/verify végponton). A * minden olyan címet továbbít, amelynek nincs saját aliasa. A GET /email/forwarding/{domain}/messages az elmúlt 30 nap leveleit listázza állapotukkal együtt; a visszatartott levelek (spam, napi limit feletti) a /release végponttal továbbíthatók.
Továbbítás helyett egy cím minden fogadott levelét elküldheti az Ön HTTPS-végpontjára JSON formátumban: a törzseket, a fejléceket és a mellékleteket base64 kódolással. A funkció egy rövid ellenőrzés után érhető el, amely során megvizsgáljuk, mire fogja használni; kérje egy domain Email-továbbítás oldalán.
$ 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
}
Az aláírás ugyanúgy működik, mint a fiókwebhookoknál: lásd az aláírás ellenőrzése.
A fiók webhookjai feliratkozhatnak az email.* eseményekre: email.mailbox.created, email.mailbox.deleted, email.forwarding.enabled és email.forwarding.disabled (ez utóbbit akkor is elküldjük, ha egy domain már nem jogosult az ingyenes továbbításra, az okkal együtt).
$ 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
Minden parancs elfogadja a --json kapcsolót. Telepítés és az összes parancs: CLI.
Az MCP segítségével egy asszisztens kilistázhatja az Ön levelezési domainjeit, ellenőrizheti azok DNS-beállításait, postafiókokat és aliasokat hozhat létre, valamint bekapcsolhatja a továbbítást. A postafiókok jelszavait soha nem kapja meg az AI: ezeket Ön a vezérlőpulton tekintheti meg.