Настройка адреса веб-приложения
Задаёт адрес веб-приложения рабочего пространства, заменяя прежний, если он был, и возвращает его вместе с записью 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.
