Vývojáři → Email
Spravujte poštu svých domén z kódu: schránky na placeném e-mailovém hostingu, bezplatné přeposílání pro domény registrované u NameOcean a příchozí poštu odesílanou do vaší aplikace jako JSON.
Vytvořte API klíč s oprávněním email:read a pro provádění změn také email:write. Všechny endpointy najdete v referenční dokumentaci API a v souboru OpenAPI. Nákup, upgrade a prodloužení e-mailového tarifu se hradí z kreditu účtu a provádí se v ovládacím panelu.
Tarif poštovní domény má velikost úložiště, kterou sdílejí všechny její schránky. Pokud schránku vytvoříte bez hesla, heslo se vygeneruje; API ho vrátí pouze v této odpovědi.
$ 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} | Schránky, aliasy, seznamy a nastavení IMAP/SMTP |
| PATCH /email/domains/{domain}/mailboxes/{username} | Změna názvu nebo kvóty |
| POST /email/domains/{domain}/mailboxes/{username}/password | Nastavení nebo vygenerování hesla |
| POST /email/domains/{domain}/aliases | Doručování jiné adresy do schránky |
| POST /email/domains/{domain}/lists | E-mailová konference ze schránek domény |
| GET /email/domains/{domain}/dns-check | NS, MX, SPF, DKIM a DMARC v reálném čase, s očekávanými hodnotami |
Domény registrované u NameOcean, které používají naše jmenné servery, mohou svou poštu přeposílat zdarma. Zapnutím se zapíše MX záznam; pokud zóna obsahuje MX záznamy jiného poskytovatele, odešlete replace_mx: true, aby byly odstraněny.
$ 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"}'
Na novou cílovou adresu přijde e-mail s odkazem a 6místným kódem a pošta se začne přeposílat, jakmile to její vlastník potvrdí (odkazem, nebo pomocí POST /email/forwarding/targets/{id}/verify s kódem). * přeposílá všechny adresy, které nemají vlastní alias. GET /email/forwarding/{domain}/messages vypíše poštu za posledních 30 dní s jejím stavem; zadrženou poštu (spam, překročení denního limitu) lze přeposlat pomocí /release.
Místo přeposílání může adresa odesílat každý přijatý e-mail na váš HTTPS endpoint jako JSON: těla, hlavičky a přílohy v base64. Funkce je dostupná po krátkém posouzení, k čemu ji budete používat; požádejte o ni na stránce Přeposílání e-mailů dané domény.
$ 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
}
Podpis funguje stejně jako u webhooků účtu: viz ověření podpisu.
Webhooky účtu se mohou přihlásit k odběru email.*: email.mailbox.created, email.mailbox.deleted, email.forwarding.enabled a email.forwarding.disabled (odesílá se také tehdy, když doména přestane splňovat podmínky pro bezplatné přeposílání, i s uvedením důvodu).
$ 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
Každý příkaz podporuje --json. Instalace a všechny příkazy: CLI.
Přes MCP může asistent vypsat vaše e-mailové domény, zkontrolovat jejich DNS, vytvořit schránky a aliasy a zapnout přeposílání. Hesla ke schránkám se nikdy neposílají AI: najdete je na nástěnce.