डोमेन जोड़ें
वर्कस्पेस में डोमेन जोड़ता है और उसे उसके लिए ज़रूरी हर DNS रिकॉर्ड के साथ लौटाता है। डोमेन असत्यापित और catch-all चालू के साथ शुरू होता है, और रिकॉर्ड के सार्वजनिक DNS में जवाब देते ही अपने आप सत्यापित हो जाता है।
असली कॉल आपकी अपनी कुंजी से आपके वर्कस्पेस पर चलाता है।
POST /domains
वर्कस्पेस में डोमेन जोड़ता है और उसे उसके लिए ज़रूरी हर DNS रिकॉर्ड के साथ लौटाता है। डोमेन असत्यापित और catch-all चालू के साथ शुरू होता है, और रिकॉर्ड के सार्वजनिक DNS में जवाब देते ही अपने आप सत्यापित हो जाता है।
अनुरोध
पैरामीटर
domainstringआवश्यक- केवल डोमेन, जैसे `acme.com` या `mail.acme.com`। इसके आगे-पीछे की खाली जगह हटाई जाती है और इसे लोअर-केस किया जाता है, और अंतरराष्ट्रीय नाम उसके ASCII रूप में सहेजा जाता है। स्कीम, पाथ या पता अस्वीकार किया जाता है।
उदाहरण
domains:write चाहिए, और बिना किसी पता या डोमेन प्रतिबंध वाली key, क्योंकि नया डोमेन पूरे वर्कस्पेस तक पहुँचता है।
curl -X POST "$OE/domains" -H "$AUTH" -H "Content-Type: application/json" \ -d '{ "domain": "acme.com" }'{ "object": "domain", "id": "b3e1f0a4-6c2d-4e8a-9f17-2d5c8a0b4e6f", "domain": "acme.com", "receiving": { "verified": false, "verifiedAt": null, "catchAll": true, "lastCheckedAt": "2026-09-25T10:00:02.000Z", "error": "No MX records yet. DNS changes can take a few minutes to spread." }, "sending": { "status": "no_identity", "canSend": false, "checkedAt": null, "error": null, "note": "Sending is not set up yet. Publish the signing record listed for this domain, and sending switches on shortly after it answers in DNS." }, "tracking": { "host": null, "status": "none", "active": false, "target": "", "record": null, "checkedAt": null, "verifiedAt": null, "error": null }, "storage": { "host": null, "status": "none", "active": false, "target": "", "record": null, "checkedAt": null, "verifiedAt": null, "error": null }, "addresses": [], "createdAt": "2026-09-25T10:00:00.000Z", "records": [ { "type": "MX", "name": "acme.com", "value": "inbound.mail.example", "priority": 10, "purpose": null, "status": "missing" }, { "type": "TXT", "name": "acme.com", "value": "v=spf1 include:_spf.openemail.uk ~all", "priority": null, "purpose": null, "status": "missing" }, { "type": "TXT", "name": "_openemail-challenge.acme.com", "value": "oe-verify=4f1c9a2b7e8d6053a1c4", "priority": null, "purpose": "Proves you own this domain", "status": "missing" } ], "dmarc": null}उदाहरण records को छोटा करता है। असली जवाब में डोमेन के लिए ज़रूरी हर रिकॉर्ड सूचीबद्ध होता है, जिसमें DMARC, signing CNAME और return-path रिकॉर्ड शामिल हैं, और GET /domains/{id} हर फ़ील्ड का वर्णन करता है।
रिकॉर्ड ठीक वैसे ही प्रकाशित करें जैसे दिए गए हैं, फिर POST /domains/{id}/verify कॉल करें या प्रतीक्षा करें। डोमेन हर बार पढ़े जाने पर और एक बैकग्राउंड स्वीप से फिर जाँचा जाता है, और पास होते ही domain.verified फ़ायर होता है।
कब अस्वीकार होता है
409domain_already_added: इस वर्कस्पेस के मालिक के पास यह डोमेन पहले से है।409domain_claimed: यह किसी दूसरे अकाउंट के पास है।409related_domain_owned: इसका कोई पैरेंट या सबडोमेन किसी दूसरे अकाउंट का है, इसलिए इसे दोनों के बीच बाँटा नहीं जा सकता।409operator_domain: यह डोमेन खुद OpenEmail का है।403domain_allowance_reached: प्लान में और डोमेन नहीं आ सकते। संदेश उस प्लान का नाम बताता है जिसमें ज़्यादा आते हैं।422capability_unsupported: key कुछ खास पतों या डोमेन तक सीमित है।
