API
استرجاع نطاق
يضيف العناوين الموجودة عليه وما إذا كان كل منها مفعّلًا.
GETapi.openemail.uk/domains/{id}
ينفّذ الاستدعاء الحقيقي على مساحة عملك، بمفتاحك أنت.
GET /domains/{id}
يضيف العناوين الموجودة عليه وما إذا كان كل منها مفعّلًا.
مثال
يتطلب domains:read.
curl "$OE/domains/b3e1f0a4-6c2d-4e8a-9f17-2d5c8a0b4e6f" -H "$AUTH"{ "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 }, "addresses": [ { "address": "[email protected]", "enabled": true }, { "address": "[email protected]", "enabled": false } ], "createdAt": "2026-08-14T09:55:11.000Z"}العنوان المعطَّل يتوقف عن كونه قابلًا للتسليم. ويُرفض البريد الموجّه إليه وقت SMTP، فيتلقى المرسِل ارتدادًا بدل الصمت.
ما لا يمكنك فعله هنا بعد
لم يُطلق بعدالكتابات التي يقبلها هذا المورد هي نطاق التتبع المخصّص ونطاق الملفات المخصّص، وكلاهما عبر PATCH /domains/{id}. أما بقية إعداد النطاق فمتاح في التطبيق وحده في الوقت الحالي.
- إضافة نطاق، وقراءة سجلات DNS الواجب نشرها. يبلّغ
GETبأن نطاقًا غير موثّق لكنه لا يبلّغ أي سجل هو الناقص. - تشغيل إعادة فحص لـ
receivingأوsending. لا توجد نقطة نهاية لأي منهما، ولا يحتاج أي منهما إليها: فمسح كل ساعة يعيد فحص كل نطاق غير موثّق من تلقاء نفسه، ومن ثم فإن نشر السجلات وتركها هو كل المهمة. اشترك فيdomain.verifiedوdomain.sending_changedبدلًا من استطلاعGET /domains، وستُبلَّغ بأي تغيّر لحظة حدوثه. أماPATCH /domains/{id}فيفحص نطاق التتبع ونطاق الملفات فقط. - إنشاء عنوان أو تعطيله أو توجيهه. أما مشاركته فمبنية بالفعل، إذ يسلّم
POST /members/{userId}/addressesعنوانًا قائمًا إلى شخص بمستوىmemberأوviewer. وما لا يستطيعه هذا المورد هو إيجاد العنوان ابتداءً.
كل ذلك موجود في التطبيق ضمن الإعدادات ثم النطاقات. فالناقص هو سطح الـ API، لا القدرة نفسها.