डोमेन की सूची
वर्कस्पेस का हर डोमेन, उसकी receiving, sending, tracking और files स्थिति के साथ।
असली कॉल आपकी अपनी कुंजी से आपके वर्कस्पेस पर चलाता है।
GET /domains
वर्कस्पेस का हर डोमेन, उसकी receiving, sending, tracking और files स्थिति के साथ।
receiving और sending अलग-अलग हैं
हर डोमेन receiving और sending को दो स्वतंत्र स्थिति ऑब्जेक्ट के रूप में बताता है। receiving.verified का अर्थ है कि डोमेन का MX उसका मेल यहाँ लाता है और उसकी स्वामित्व चुनौती प्रकाशित है, यानी डोमेन डिलीवरी ले सकता है। यह outbound के बारे में कुछ नहीं कहता।
sending बाहर जाने वाला आधा हिस्सा है, जो ताज़ा जाँच के बजाय डोमेन की संग्रहीत signing जाँच से पढ़ा जाता है। sending.status इनमें से एक होता है: verified, pending, failed, no_identity या unknown; sending.canSend बताता है कि अभी इस डोमेन से भेजा गया मेल स्वीकार होगा या नहीं; sending.checkedAt उस निर्णय की तारीख़ है; sending.error पिछली विफलता रखता है; और sending.note एक वाक्य है जो स्थिति समझाता है। एक दिन से पुराना नकारात्मक निर्णय अस्वीकृति के बजाय अज्ञात माना जाता है, इसलिए status के pending रहते हुए भी canSend true हो सकता है।
tracking एक तीसरा ऑब्जेक्ट है, जो डोमेन के मेल के बजाय उसके वैकल्पिक कस्टम tracking डोमेन के बारे में है। जब तक कोई सेट न हो, ऐप में या PATCH /domains/{id} से, tracking.status none रहता है, और उसी एंडपॉइंट का पृष्ठ हर फ़ील्ड का वर्णन करता है।
storage उन्हीं फ़ील्ड वाला चौथा ऑब्जेक्ट है, जो डोमेन के वैकल्पिक कस्टम files डोमेन के बारे में है: वह नाम जिसका उपयोग इस डोमेन से भेजी गई फ़ाइलों के डाउनलोड लिंक करते हैं। इसे उसी तरह और उसी पृष्ठ पर सेट किया जाता है, और जब तक कोई सेट न हो storage.status none रहता है।
उदाहरण
domains:read चाहिए।
curl "$OE/domains" -H "$AUTH"{ "object": "list", "data": [ { "object": "domain", "id": "b3e1f0a4-6c2d-4e8a-9f17-2d5c8a0b4e6f", "domain": "acme.com", "receiving": { "verified": true, "verifiedAt": "2026-08-14T10:02:00.000Z", "catchAll": false, "lastCheckedAt": "2026-08-29T06:00:00.000Z", "error": null }, "sending": { "status": "verified", "canSend": true, "checkedAt": "2026-08-29T06:00:00.000Z", "error": null, "note": "Mail from this domain is signed and can be sent." }, "tracking": { "host": "links.acme.com", "status": "active", "active": true, "target": "oelinks3f9a1c7e2b8d4a60.edge.openemail.uk", "record": { "type": "CNAME", "name": "links.acme.com", "value": "oelinks3f9a1c7e2b8d4a60.edge.openemail.uk" }, "checkedAt": "2026-08-29T06:10:00.000Z", "verifiedAt": "2026-08-29T06:10:00.000Z", "error": null }, "storage": { "host": "files.acme.com", "status": "active", "active": true, "target": "oefiles81c40d6b2f7e9a35.edge.openemail.uk", "record": { "type": "CNAME", "name": "files.acme.com", "value": "oefiles81c40d6b2f7e9a35.edge.openemail.uk" }, "checkedAt": "2026-08-29T06:10:00.000Z", "verifiedAt": "2026-08-29T06:10:00.000Z", "error": null }, "createdAt": "2026-08-14T09:55:11.000Z" } ]}lastCheckedAt का null होना मतलब DNS को अभी तक देखा ही नहीं गया: "हमने अभी देखा नहीं", न कि "यह विफल हुआ"। डोमेन जोड़ने के तीस सेकंड बाद इन दोनों का मतलब बहुत अलग होता है।