Dasturchilar → Email

Email API

Domenlaringiz pochtasini kod orqali boshqaring: pullik email hostingdagi pochta qutilari, NameOcean’da ro‘yxatdan o‘tgan domenlar uchun bepul yo‘naltirish va ilovangizga JSON ko‘rinishida yuboriladigan kiruvchi xatlar.

Boshlashdan oldin

email:read ruxsatiga ega API kalit yarating, o‘zgartirishlar kiritish uchun esa email:write ham qo‘shing. Barcha endpointlar API ma’lumotnomasida va OpenAPI faylida keltirilgan. Pochta tarifini sotib olish, yangilash va uzaytirish hisobingiz balansidan to‘lanadi va boshqaruv panelida amalga oshiriladi.

Pochta qutilari

Pochta domeni tarifida pochta qutilari birgalikda foydalanadigan saqlash hajmi mavjud. Pochta qutisini parolsiz yaratsangiz, parol avtomatik yaratiladi; API uni faqat shu javobda qaytaradi.

curl

$ 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}	Pochta qutilari, taxalluslar, ro‘yxatlar va IMAP/SMTP sozlamalari
PATCH /email/domains/{domain}/mailboxes/{username}	Nom yoki kvotani o‘zgartirish
POST /email/domains/{domain}/mailboxes/{username}/password	Parol o‘rnatish yoki yaratish
POST /email/domains/{domain}/aliases	Boshqa manzilga kelgan xatlarni pochta qutisiga yetkazish
POST /email/domains/{domain}/lists	Domen pochta qutilaridan iborat pochta ro‘yxati
GET /email/domains/{domain}/dns-check	NS, MX, SPF, DKIM va DMARC — joriy holat va kutilgan qiymatlar bilan

Bepul yo‘naltirish

NameOcean’da ro‘yxatdan o‘tgan va bizning nameserverlarimizdan foydalanadigan domenlar pochtasini bepul yo‘naltirishi mumkin. Uni yoqish MX yozuvini qo‘shadi; agar zonada boshqa provayderning MX yozuvlari bo‘lsa, ularni o‘chirish uchun replace_mx: true yuboring.

curl

$ 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"}'

Yangi maqsad manzilga havola va 6 xonali kod bilan xat yuboriladi, egasi tasdiqlagandan so‘ng (havola orqali yoki kod bilan POST /email/forwarding/targets/{id}/verify) pochta yo‘naltiriladi. * o‘z taxallusiga ega bo‘lmagan barcha manzillarni yo‘naltiradi. GET /email/forwarding/{domain}/messages so‘nggi 30 kunlik xatlarni holati bilan ko‘rsatadi; ushlab qolingan xatlarni (spam, kunlik limitdan oshgan) /release orqali yo‘naltirish mumkin.

Kiruvchi xatlarni webhookka yuborish

Yo‘naltirish o‘rniga manzil qabul qilgan har bir xatni HTTPS endpointingizga JSON ko‘rinishida yuborishi mumkin: matn, sarlavhalar va base64 formatidagi ilovalar bilan. Bu imkoniyat undan qanday maqsadda foydalanishingiz qisqacha ko‘rib chiqilgach ochiladi; so‘rovni domenning Email Forwarding sahifasida yuboring.

curl

$ 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"}'

POST 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
}

Imzo hisob webhooklari kabi ishlaydi: imzoni tekshirish bo‘limiga qarang.

Hodisalar

Hisob webhooklari email.* hodisalariga obuna bo‘lishi mumkin: email.mailbox.created, email.mailbox.deleted, email.forwarding.enabled va email.forwarding.disabled (domen bepul yo‘naltirish shartlariga javob bermay qolganda ham sababi bilan yuboriladi).

Terminaldan

nameocean

$ 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

Har bir buyruq --json parametrini qabul qiladi. O'rnatish va barcha buyruqlar: CLI.

Sun’iy intellektingiz orqali

MCP orqali yordamchi pochta domenlaringiz ro‘yxatini ko‘rishi, ularning DNS sozlamalarini tekshirishi, pochta qutilari va taxalluslar yaratishi hamda yo‘naltirishni yoqishi mumkin. Pochta qutisi parollari hech qachon sun’iy intellektga yuborilmaydi: ularni boshqaruv panelida ko‘rasiz.