ضبط عنوان تطبيق الويب
يضبط عنوان تطبيق الويب لمساحة العمل، ليحلّ محل أي عنوان كان لديها، ويعيده مع سجل CNAME الواجب نشره.
ينفّذ الاستدعاء الحقيقي على مساحة عملك.
PUT /app-host
يضبط عنوان تطبيق الويب لمساحة العمل، ليحلّ محل أي عنوان كان لديها، ويعيده مع سجل CNAME الواجب نشره.
الطلب
المعاملات
hoststringمطلوب- نطاق فرعي من نطاق موثّق في مساحة العمل هذه، مثل `mailbox.acme.com`، بحد أقصى 253 حرفًا. يُحوَّل إلى أحرف صغيرة، وتُزال منه بادئة `https://` والمسار والنقطة في النهاية. ولا يمكن استخدام النطاق وحده.
مثال
يتطلب domains:write، وخطة مدفوعة، ومفتاحًا بلا قيود على العناوين أو النطاقات.
curl -X PUT "$OE/app-host" -H "$AUTH" -H "Content-Type: application/json" \ -d '{ "host": "mailbox.acme.com" }'{ "object": "app_host", "id": "ahost_3f9c2a71d0b84e56a1c7f2e9", "host": "mailbox.acme.com", "domainId": "b3e1f0a4-6c2d-4e8a-9f17-2d5c8a0b4e6f", "domain": "acme.com", "status": "pending", "active": false, "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": null, "available": true, "paidPlan": true, "domains": ["acme.com"], "suggested": "mailbox.acme.com"}يبدأ العنوان بالحالة pending. انشر record لدى مزوّد DNS كما هو تمامًا، ثم كرّر استدعاء GET /app-host أو استدعِ POST /app-host/verify. ويعمل بعد دقائق قليلة من استجابة السجل، بمجرد إصدار شهادته.
ضبط العنوان الذي لدى مساحة العمل بالفعل لا يغيّر شيئًا ويعيد فحصه. والعنوان على نطاق آخر يحلّ محل القديم بمجرد إعداده، أما العنوان على النطاق نفسه فيحلّ محله فورًا. ويُسجَّل خروج كل من كان مسجّلًا الدخول على عنوان استُبدل.
مساحة العمل المجانية تجيب بـ 403 plan_required. والعنوان خارج نطاقات مساحة العمل يجيب بـ 422 invalid_app_host، والعنوان على نطاق غير موثّق بـ 409 domain_not_verified، والعنوان الذي تستخدمه مساحة عمل أخرى بـ 409 app_host_in_use.
