تخطَّ إلى المستندات
API

استرجاع نطاق

يضيف العناوين الموجودة عليه وما إذا كان كل منها مفعّلًا.

GETapi.openemail.uk/domains/{id}

ينفّذ الاستدعاء الحقيقي على مساحة عملك، بمفتاحك أنت.

GET /domains/{id}

يضيف العناوين الموجودة عليه وما إذا كان كل منها مفعّلًا.

مثال

يتطلب domains:read.

curl
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، لا القدرة نفسها.