استرجاع عنوان تطبيق الويب
عنوان تطبيق الويب لمساحة العمل، وما إذا كان الناس يستطيعون تسجيل الدخول هناك، وسجل CNAME الذي يحتاجه. وحين لا يكون أي عنوان مضبوطًا، تكون `status` هي `none` وتسرد `domains` النطاقات التي يمكن وضع العنوان تحتها.
ينفّذ الاستدعاء الحقيقي على مساحة عملك.
GET /app-host
عنوان تطبيق الويب لمساحة العمل، وما إذا كان الناس يستطيعون تسجيل الدخول هناك، وسجل CNAME الذي يحتاجه. وحين لا يكون أي عنوان مضبوطًا، تكون status هي none وتسرد domains النطاقات التي يمكن وضع العنوان تحتها.
ما هو عنوان تطبيق الويب
export OE=https://api.openemail.ukexport AUTH="Authorization: Bearer $OPENEMAIL_API_KEY"يمكن لمساحة العمل على خطة مدفوعة أن تفتح تطبيق الويب على نطاق فرعي من أحد نطاقاتها الموثّقة، مثل mailbox.acme.com، إلى جانب openemail.uk. وهو العنوان الذي يضبطه تبويب تطبيق بعلامتك في إعدادات المظهر لمساحة العمل، ولكل مساحة عمل عنوان واحد على الأكثر.
لا يستطيع تسجيل الدخول هناك إلا أعضاء مساحة العمل، ومن يسجّلون الدخول بأحد عناوينها، وكل من لديه دعوة معلّقة، وهم وحدهم من يتلقّون منه رسائل إعادة تعيين كلمة المرور والتحقق. ويبدو مثل openemail.uk إلى أن تضبط مساحة العمل شعارًا في صفحة المظهر، ثم يعرض شعار مساحة العمل ورمزها واسمها بدلًا مما لدينا. ومنذ ذلك الحين تحمل الرسائل التي يرسلها OpenEmail إليهم العلامة التجارية، وتعود روابطها إلى العنوان، وتأتي من noreply@ نطاقها بعد التحقق من سجلات التوقيع لذلك النطاق.
يحتاج إلى سجل CNAME واحد، يبيّنه record بالتفصيل. ويكون العنوان pending حتى يستجيب السجل وتصدر شهادته، ثم active بعد ذلك. وفي الخطة المجانية يُحتفظ به لكنه يتوقف مؤقتًا: تكون paused صحيحة ولا يستطيع أحد تسجيل الدخول هناك حتى تعود مساحة العمل إلى خطة مدفوعة.
مثال
يتطلب domains:read.
curl "$OE/app-host" -H "$AUTH"{ "object": "app_host", "id": "ahost_3f9c2a71d0b84e56a1c7f2e9", "host": "mailbox.acme.com", "domainId": "b3e1f0a4-6c2d-4e8a-9f17-2d5c8a0b4e6f", "domain": "acme.com", "status": "active", "active": true, "paused": false, "target": "cname.openemail.uk", "record": { "type": "CNAME", "name": "mailbox.acme.com", "value": "cname.openemail.uk" }, "error": null, "checkedAt": "2026-10-01T09:12:30.000Z", "verifiedAt": "2026-10-01T09:04:11.000Z", "available": true, "paidPlan": true, "domains": ["acme.com"], "suggested": "mailbox.acme.com"}قراءته تعيد فحص العنوان إذا مضى على فحصه الأخير أكثر من 15 ثانية، لذا فالاستقصاء المتكرر لهذا المسار هو طريقة انتظار أن تصبح active صحيحة.
تكون active صحيحة فقط حين تكون status هي active وتكون مساحة العمل على خطة مدفوعة. وتكون paused صحيحة حين يكون هناك عنوان مضبوط وتكون مساحة العمل على الخطة المجانية.