Geliştiriciler → Email
Alan adlarınızın postalarını koddan yönetin: ücretli e-posta barındırmada posta kutuları, NameOcean'da kayıtlı alan adları için ücretsiz yönlendirme ve uygulamanıza JSON olarak gönderilen gelen postalar.
email:read ve değişiklik yapmak için email:write yetkisine sahip bir API anahtarı oluşturun. Tüm uç noktalar API referansında ve OpenAPI dosyasında yer alır. Posta paketi satın alma, yükseltme ve yenileme işlemleri hesap bakiyesinden düşülür ve kontrol panelinden yapılır.
Bir posta alan adının paketinde, posta kutularının paylaştığı bir depolama alanı bulunur. Parola belirtmeden bir posta kutusu oluşturursanız otomatik olarak bir parola üretilir; API bu parolayı yalnızca bu yanıtta döndürür.
$ 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} | Posta kutuları, takma adlar, listeler ve IMAP/SMTP ayarları |
| PATCH /email/domains/{domain}/mailboxes/{username} | Adı veya kotayı değiştirin |
| POST /email/domains/{domain}/mailboxes/{username}/password | Parola belirleyin veya oluşturun |
| POST /email/domains/{domain}/aliases | Başka bir adresi posta kutusuna iletin |
| POST /email/domains/{domain}/lists | Alan adının posta kutularından oluşan bir e-posta listesi |
| GET /email/domains/{domain}/dns-check | NS, MX, SPF, DKIM ve DMARC kayıtları, beklenen değerlerle birlikte canlı olarak |
NameOcean'da kayıtlı ve ad sunucularımızı kullanan alan adları postalarını ücretsiz olarak yönlendirebilir. Yönlendirmeyi açmak MX kaydını oluşturur; bölgede başka bir sağlayıcının MX kayıtları varsa bunları kaldırmak için replace_mx: true gönderin.
$ 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"}'
Yeni bir hedef adrese bağlantı ve 6 haneli kod içeren bir e-posta gönderilir; adres sahibi onayladıktan sonra (bağlantıyla veya kodla birlikte POST /email/forwarding/targets/{id}/verify isteğiyle) postalar yönlendirilir. *, kendi takma adı olmayan tüm adresleri yönlendirir. GET /email/forwarding/{domain}/messages son 30 günün postalarını durumlarıyla birlikte listeler; bekletilen postalar (spam, günlük sınırı aşan) /release ile yönlendirilebilir.
Yönlendirme yerine bir adres, aldığı her postayı HTTPS uç noktanıza JSON olarak gönderebilir: gövdeler, başlıklar ve base64 biçiminde ekler. Ne için kullanacağınıza dair kısa bir incelemenin ardından kullanıma açılır; bir alan adının E-posta Yönlendirme sayfasından talep edin.
$ 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
}
İmza, hesap webhook'larıyla aynı şekilde çalışır: imza doğrulama bölümüne bakın.
Hesap webhook'ları email.* olaylarına abone olabilir: email.mailbox.created, email.mailbox.deleted, email.forwarding.enabled ve email.forwarding.disabled (bir alan adı ücretsiz yönlendirme koşullarını artık karşılamadığında da nedeniyle birlikte gönderilir).
$ 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
Her komut --json seçeneğini destekler. Kurulum ve tüm komutlar: CLI.
Bir asistan, MCP üzerinden e-posta alan adlarınızı listeleyebilir, DNS kayıtlarını kontrol edebilir, posta kutuları ve takma adlar oluşturabilir ve yönlendirmeyi açabilir. Posta kutusu parolaları asla yapay zekâya gönderilmez: bunları kontrol panelinden görüntülersiniz.