Web uygulaması adresini ayarlama
Çalışma alanının web uygulaması adresini ayarlar, varsa öncekinin yerine koyar ve adresi yayımlanacak CNAME kaydıyla birlikte döndürür.
Gerçek çağrıyı çalışma alanınızda çalıştırır.
PUT /app-host
Çalışma alanının web uygulaması adresini ayarlar, varsa öncekinin yerine koyar ve adresi yayımlanacak CNAME kaydıyla birlikte döndürür.
İstek
Parametreler
hoststringzorunlu- Bu çalışma alanının doğrulanmış bir alan adının alt alan adı, örneğin `mailbox.acme.com`; en çok 253 karakter. Küçük harfe çevrilir; `https://` öneki, yol ve sondaki nokta ayıklanır. Yalın alan adı kullanılamaz.
Örnek
domains:write, ücretli bir plan ve adres ya da alan adı kısıtlaması olmayan bir anahtar gerektirir.
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"}Adres pending olarak başlar. record kaydını DNS sağlayıcınızda tam olarak verildiği gibi yayımlayın, ardından GET /app-host ile yoklayın ya da POST /app-host/verify çağırın. Adres, kayıt yanıt verdikten birkaç dakika sonra, sertifikası verildiğinde yayına girer.
Zaten sahip olduğu adresi ayarlamak hiçbir şeyi değiştirmez ve adresi yeniden denetler. Başka bir alan adındaki adres, kurulduğunda eskisinin yerini alır; aynı alan adındaki adres ise yerini hemen alır. Yerine yenisi gelen adreste oturum açmış herkesin oturumu kapanır.
Ücretsiz bir çalışma alanı 403 plan_required yanıtını verir. Çalışma alanının alan adları dışındaki bir adres 422 invalid_app_host, doğrulanmamış bir alan adındaki adres 409 domain_not_verified, başka bir çalışma alanının kullandığı adres ise 409 app_host_in_use yanıtını verir.
