Dezvoltatori → Email
Gestionați e-mailul domeniilor dvs. din cod: căsuțe poștale pe găzduirea de e-mail plătită, redirecționare gratuită pentru domeniile înregistrate la NameOcean și e-mailurile primite trimise către aplicația dvs. ca JSON.
Creați o cheie API cu email:read și email:write pentru a face modificări. Toate endpointurile se află în referința API și în fișierul OpenAPI. Cumpărarea, upgrade-ul și reînnoirea unui plan de e-mail consumă credit din cont și se fac din panoul de control.
Planul unui domeniu de e-mail are un spațiu de stocare partajat de căsuțele sale poștale. Dacă creați o căsuță poștală fără parolă, se generează una; răspunsul este singura dată când API-ul o returnează.
$ 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} | Căsuțe poștale, aliasuri, liste și setările IMAP/SMTP |
| PATCH /email/domains/{domain}/mailboxes/{username} | Schimbați numele sau cota |
| POST /email/domains/{domain}/mailboxes/{username}/password | Setați o parolă sau generați una |
| POST /email/domains/{domain}/aliases | Livrați o altă adresă către o căsuță poștală |
| POST /email/domains/{domain}/lists | O listă de e-mail cu căsuțele poștale ale domeniului |
| GET /email/domains/{domain}/dns-check | NS, MX, SPF, DKIM și DMARC, în timp real, cu valorile așteptate |
Domeniile înregistrate la NameOcean care folosesc serverele noastre de nume își pot redirecționa e-mailul gratuit. Activarea scrie înregistrarea MX; dacă zona are înregistrări MX ale altui furnizor, trimiteți replace_mx: true pentru a le elimina.
$ 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"}'
O nouă adresă de destinație primește un e-mail cu un link și un cod de 6 cifre, iar e-mailurile sunt redirecționate după ce proprietarul confirmă (prin link sau prin POST /email/forwarding/targets/{id}/verify cu codul). * redirecționează orice adresă care nu are propriul alias. GET /email/forwarding/{domain}/messages listează e-mailurile din ultimele 30 de zile cu starea lor; e-mailurile reținute (spam, peste limita zilnică) pot fi redirecționate cu /release.
În loc de redirecționare, o adresă poate trimite fiecare e-mail primit către endpointul dvs. HTTPS ca JSON: conținut, antete și atașamente în base64. Funcția este disponibilă după o scurtă analiză a modului în care o veți folosi; solicitați-o din pagina Email Forwarding a unui domeniu.
$ 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
}
Semnătura funcționează la fel ca la webhookurile contului: consultați verificarea unei semnături.
Webhookurile contului se pot abona la email.*: email.mailbox.created, email.mailbox.deleted, email.forwarding.enabled și email.forwarding.disabled (trimis și când un domeniu nu mai îndeplinește condițiile pentru redirecționarea gratuită, împreună cu motivul).
$ 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
Fiecare comandă acceptă --json. Instalare și toate comenzile: CLI.
Prin MCP, un asistent poate lista domeniile dumneavoastră de e-mail, le poate verifica DNS-ul, poate crea căsuțe de e-mail și aliasuri și poate activa redirecționarea. Parolele căsuțelor de e-mail nu sunt trimise niciodată către AI: le găsiți în panoul de control.