वेब ऐप का पता सेट करें
वर्कस्पेस के वेब ऐप का पता सेट करता है, पहले से मौजूद किसी भी पते की जगह, और उसे प्रकाशित करने वाले CNAME रिकॉर्ड के साथ लौटाता है।
असली कॉल आपके वर्कस्पेस पर चलाता है।
PUT /app-host
वर्कस्पेस के वेब ऐप का पता सेट करता है, पहले से मौजूद किसी भी पते की जगह, और उसे प्रकाशित करने वाले CNAME रिकॉर्ड के साथ लौटाता है।
अनुरोध
पैरामीटर
hoststringआवश्यक- इस वर्कस्पेस के किसी सत्यापित डोमेन का सबडोमेन, जैसे `mailbox.acme.com`, अधिकतम 253 अक्षर। इसे lowercase किया जाता है, और `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 को poll करें या POST /app-host/verify कॉल करें। रिकॉर्ड के जवाब देने के कुछ मिनट बाद, सर्टिफ़िकेट जारी होते ही, यह चालू हो जाता है।
जो पता पहले से सेट है, उसे ही सेट करने से कुछ नहीं बदलता और वह फिर से जाँचा जाता है। किसी दूसरे डोमेन का पता सेट अप होते ही पुराने पते की जगह ले लेता है, और उसी डोमेन का पता तुरंत उसकी जगह ले लेता है। जिस पते की जगह नया पता आया, वहाँ साइन इन किए हुए सभी लोग साइन आउट हो जाते हैं।
फ़्री वर्कस्पेस 403 plan_required लौटाता है। वर्कस्पेस के डोमेन से बाहर का पता 422 invalid_app_host लौटाता है, असत्यापित डोमेन का पता 409 domain_not_verified, और कोई दूसरा वर्कस्पेस जिस पते का इस्तेमाल करता है वह 409 app_host_in_use।
