تنظیم نشانی برنامه وب
نشانی برنامه وب فضای کاری را تنظیم می‌کند، به‌جای هر نشانی‌ای که پیش‌تر داشت، و آن را همراه رکورد 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.
