• Быстрый старт
    • Демо
  • УСТРОЙСТВО
    • Страницы
      • Markdown
      • Аналитика страниц
    • Фреймы
      • Поля данных
      • Сборка
    • Данные
    • Приложения
      • Данные приложения
    • Медиа
  • УПРАВЛЕНИЕ
    • Создание сайтов
    • Настройки
    • Меню
    • Приватные страницы
    • Языки
    • Свой домен
    • Пользователи
    • Стили и оформление
    • Соцсети и контакты
    • Ошибки и проблемы
  • ИНСТРУМЕНТЫ
    • SEO
    • Индексация
    • Кросспостинг
    • Аналитика
    • Кэш
    • Почта на домене
    • Редиректы
  • КЕЙСЫ
    • Загрузить HTML
    • Миграция
    • Перевод страницы
    • Чат с OpenAI
    • Справочник API
    • Общие правила
  • УСТРОЙСТВО
    • Страницы
    • Фреймы
      • Поля данных
      • Повторитель
      • Вставка фрейма и служебные блоки
      • Готовые фреймы
      • Сборка
    • Данные
    • Медиа
  • УПРАВЛЕНИЕ
    • Создание сайтов
    • Настройки
    • Меню
    • Языки
    • Свой домен
    • Пользователи
    • Кредиты
    • Автоматизация
    • Авторизация
      • Состояние API
      • Сессия посетителя
    • Стили и оформление
    • Соцсети и контакты
    • Ошибки и проблемы
  • ИНСТРУМЕНТЫ
    • SEO
      • Семантика
    • Индексация
    • Кросспостинг
    • Аналитика
    • Кэш
    • Почта на домене
    • Редиректы
OnPress OnPress
Документация Справочник API Контакты
Войти Начать
Документация Справочник API Контакты Войти
    • Быстрый старт
    • Демо
  • УСТРОЙСТВО
    • Страницы
      • Markdown
      • Аналитика страниц
    • Фреймы
      • Поля данных
      • Сборка
    • Данные
    • Приложения
      • Данные приложения
    • Медиа
  • УПРАВЛЕНИЕ
    • Создание сайтов
    • Настройки
    • Меню
    • Приватные страницы
    • Языки
    • Свой домен
    • Пользователи
    • Стили и оформление
    • Соцсети и контакты
    • Ошибки и проблемы
  • ИНСТРУМЕНТЫ
    • SEO
    • Индексация
    • Кросспостинг
    • Аналитика
    • Кэш
    • Почта на домене
    • Редиректы
  • КЕЙСЫ
    • Загрузить HTML
    • Миграция
    • Перевод страницы
    • Чат с OpenAI
    • Справочник API
    • Общие правила
  • УСТРОЙСТВО
    • Страницы
    • Фреймы
      • Поля данных
      • Повторитель
      • Вставка фрейма и служебные блоки
      • Готовые фреймы
      • Сборка
    • Данные
    • Медиа
  • УПРАВЛЕНИЕ
    • Создание сайтов
    • Настройки
    • Меню
    • Языки
    • Свой домен
    • Пользователи
    • Кредиты
    • Автоматизация
    • Авторизация
      • Состояние API
      • Сессия посетителя
    • Стили и оформление
    • Соцсети и контакты
    • Ошибки и проблемы
  • ИНСТРУМЕНТЫ
    • SEO
      • Семантика
    • Индексация
    • Кросспостинг
    • Аналитика
    • Кэш
    • Почта на домене
    • Редиректы
Справочник API Управление
Markdown
Открыть в ИИ
  • Открыть в ChatGPT
  • Открыть в Claude
  • Открыть в Gemini
  • Открыть в Perplexity
  • Открыть в Grok
  • Открыть в DeepSeek

Домен

API подключает собственный домен к сайту, меняет адрес платформы, показывает статус подключения и освобождает адрес со снятием публикации сайта. Настройка DNS — в гайде «Домен».

МетодПутьДействие
PUT/data/domainПодключить домен
GET/data/domainПолучить статус подключения
DELETE/data/domainОтключить домен
info

Во всех примерах API — https://onpress.pro/api/v2, SITE — id сайта (SITE_ID), OP_TOKEN — токен op_XXXX. Права на всех эндпоинтах страницы — администратор сайта. Как получить токен и в какой форме приходят отказы — Авторизация.

Подключить домен

PUT /data/domain

Подключает собственный домен к сайту или меняет его адрес в зоне onpress.pro (адрес в этой зоне меняет только суперадмин сети). Для собственного домена платформа ведет подключение сама: ждет записи DNS, выпускает сертификат и переводит сайт на домен. Сайт на другом своем домене работает на нем, пока новый не станет active; старый домен после перевода снимается с сервера. Повтор после failed начинает подключение заново. Например, подключить example.com:

curl -s -X PUT "$API/site/$SITE/data/domain" \
  -H "Authorization: Bearer $OP_TOKEN" -H 'Content-Type: application/json' \
  -d '{"domain": "example.com"}'

Адрес платформы выдается сайту при создании, и сменить его может только суперадмин сети — остальным PUT с адресом .onpress.pro отвечает 403 insufficient_role. Суперадмин меняет его тем же запросом: если сайт работает на old-name.onpress.pro, передайте свободный адрес, например:

curl -s -X PUT "$API/site/$SITE/data/domain" \
  -H "Authorization: Bearer $OP_TOKEN" -H 'Content-Type: application/json' \
  -d '{"domain": "new-name.onpress.pro"}'

Платформа меняет адрес сайта и обновляет его публикацию. В items[0] приходят mode: "assign", status: "none", новый site_domain и site_url, а domain равен null. Отдельная настройка DNS для адреса платформы не нужна. Прежний адрес освобождается. Чтобы перевести сайт с собственного домена обратно на адрес платформы, используйте DELETE /data/domain с полем to.

Параметры пути. Сайт задает общий префикс /site/{siteId}; выбор сайта.

Параметры строки запроса

ПараметрТипОбязателенПо умолчаниюОписание
dry_runbooleanнетfalseпроверить запрос без записи; общие правила

Параметры тела

ПолеТипОбязателенПо умолчаниюОписание
domainstringда—собственный домен, например example.com, или свободный адрес <name>.onpress.pro. Для собственного домена схема, путь, порт и www. отбрасываются, кириллица переводится в punycode. Адрес платформы передавайте только именем хоста, без этих частей. Имя перед .onpress.pro — от 1 до 50 строчных латинских букв, цифр и дефисов, без дефиса по краям; вложенные и зарезервированные имена отклоняются
dry_runboolнетfalseпроверить подключение собственного домена или смену адреса платформы без записи; можно и ?dry_run=1

Для адресов платформы зарезервированы имена www, api, admin, mail, ftp, cdn, static, app, apps, stage, test, dashboard, docs, support, status, storage, assets, base-v2 и onpress.

Ответ

{
  "success": true,
  "site_id": "FJyyv3Xiv",
  "name": "domain",
  "origin": "system",
  "contextual": false,
  "writable": true,
  "write": {
    "method": "PUT",
    "methods": [
      "PUT",
      "DELETE"
    ],
    "at": "/data/domain",
    "forwards_to": "the existing domain connection service of the selected site",
    "dry_run": true,
    "body": "{\"domain\":\"example.com\",\"dry_run\"?:true} connects an external domain with the existing DNS and certificate lifecycle, or renames the platform address to a free non-reserved <name>.onpress.pro hostname",
    "changes": "the custom domain of the selected site; DNS, certificate and switching status are returned in items[0]",
    "delete": {
      "method": "DELETE",
      "dry_run": true,
      "body": "without to: release the domain and take the retained site offline; {\"to\":\"mysite.onpress.pro\",\"dry_run\"?:true} keeps the address-change flow"
    }
  },
  "total": 1,
  "items": [
    {
      "status": "pending_dns",
      "domain": "example.com",
      "site_domain": "mysite.onpress.pro",
      "site_url": "https://mysite.onpress.pro",
      "server_ip": "31.128.47.177",
      "started_at": "2026-10-27T12:03:56+00:00",
      "elapsed": 0,
      "dns": {
        "ok": false,
        "records": [
          {
            "type": "A",
            "host": "example.com",
            "value": "31.128.47.177",
            "found": [],
            "ok": false
          },
          {
            "type": "A",
            "host": "www.example.com",
            "value": "31.128.47.177",
            "found": [],
            "ok": false
          }
        ],
        "problems": []
      },
      "previous_domain": "mysite.onpress.pro",
      "next": "add the DNS records from dns.records at your registrar; …"
    }
  ],
  "dry_run": false,
  "changed": true,
  "applied": true,
  "source": "domain"
}

changed: false — домен уже активен, подключение уже идет или адрес платформы совпадает с текущим. При подключении собственного домена applied: true означает старт изменения, а не завершение подключения. Текущее состояние находится в items[0], как у GET /data/domain.

Запись возвращает тот же конверт данных, что и чтение, с полями source, dry_run, changed и applied. При пробном прогоне applied: false, а items[0] содержит план; у плана может не быть status и site_url. Общие правила пробного прогона.

Ошибки

КодHTTPКогдаЧто делать
lang_not_accepted400у домена нет языковых вариантовуберите lang из строки запроса и тела
source_auth_required403источник вызван без пользователя с правами на сайтпередайте токен администратора сайта
wrong_method_for_source405метод не поддерживает источник domainиспользуйте GET, PUT или DELETE
invalid_domain400не имя хостапередайте домен вида example.com
invalid_platform_domain400адрес платформы вложенный, зарезервирован, содержит схему или путь либо имя не подходит по длине и символампередайте свободный прямой адрес вида my-site.onpress.pro
insufficient_role403запрошен адрес .onpress.pro, а вы не суперадмин сетиадрес платформы выдается при создании сайта; подключите собственный домен
use_domain_disconnect409сайт работает на собственном домене, а PUT запрашивает адрес платформыверните сайт через DELETE /data/domain с нужным to
platform_domain400собственный домен относится к служебной зоне платформывыберите собственный домен или прямой адрес .onpress.pro
unknown_field400в теле лишнее полеоставьте domain и dry_run
site_not_found404сайта нет или он не вашпроверьте {id}
domain_taken409собственный домен или адрес платформы уже у другого сайтаосвободите адрес на другом своем сайте или выберите свободный
domain_changed_meanwhile409адрес сайта изменился во время обработки запросапрочитайте состояние и повторите запрос
domain_busy409идет выпуск сертификата или переезд, текущий статус в current_statusповторите через минуту
main_site_locked409домен главного сайта платформы не меняетсяпроверьте параметр из message и повторите запрос
wrong_realm409запрос пришел не на рабочий адрес APIповторите на адресе из сообщения
domain_step_failedстатус шага или 502шаг подключения не выполнился; причина — в messageисправьте причину и повторите запрос
internal_unavailable502сайт не ответилповторите запрос
domain_publisher_missing, domain_storage_failed503публикация нового адреса или очистка прежнего не завершиласьповторите позже; при повторном отказе передайте код и id сайта в поддержку

Получить статус подключения

GET /data/domain

Возвращает состояние домена в единственной записи items[0] системных данных domain. При незавершенном подключении чтение запускает проверку, а первое чтение после перевода сбрасывает кэши и пересобирает фреймы; результат приходит один раз в items[0].finished. Например:

curl -s "$API/site/$SITE/data/domain" -H "Authorization: Bearer $OP_TOKEN"

Параметры пути. Сайт задает общий префикс /site/{siteId}; выбор сайта.

Параметры строки запроса. Дополнительных параметров нет.

Тело запроса. Не требуется.

Ответ

{
  "success": true,
  "site_id": "x9HTLHECq",
  "name": "domain",
  "origin": "system",
  "contextual": false,
  "writable": true,
  "write": {
    "method": "PUT",
    "methods": [
      "PUT",
      "DELETE"
    ],
    "at": "/data/domain",
    "forwards_to": "the existing domain connection service of the selected site",
    "dry_run": true,
    "body": "{\"domain\":\"example.com\",\"dry_run\"?:true} connects an external domain with the existing DNS and certificate lifecycle, or renames the platform address to a free non-reserved <name>.onpress.pro hostname",
    "changes": "the custom domain of the selected site; DNS, certificate and switching status are returned in items[0]",
    "delete": {
      "method": "DELETE",
      "dry_run": true,
      "body": "without to: release the domain and take the retained site offline; {\"to\":\"mysite.onpress.pro\",\"dry_run\"?:true} keeps the address-change flow"
    }
  },
  "total": 1,
  "items": [
    {
      "status": "none",
      "domain": null,
      "site_domain": "test.onpress.pro",
      "site_url": "https://test.onpress.pro",
      "server_ip": "31.128.47.177",
      "next": "PUT /data/domain with {\"domain\": \"example.com\"} to connect a domain"
    }
  ]
}
statusЧто происходит
noneсайт работает на адресе платформы, подключения собственного домена нет
detachedадрес освобожден, публичная публикация снята; данные сайта сохранены
pending_dnsждем A-записи example.com и www.example.com на server_ip; проверка через публичные DNS (8.8.8.8, 1.1.1.1, 9.9.9.9)
issuing_certLet’s Encrypt выпускает сертификат на example.com и www.example.com
switchingсайт переходит на https://example.com
activeсайт работает на домене; www и http:// ведут на https://example.com
disconnectingсайт возвращается на адрес платформы
failedостановлено: failed_stage — dns (записи не появились за 24 часа), cert (сертификат не выпущен), switch или disconnect; причина — в error
ПолеОписание
domainподключаемый или действующий свой домен, иначе null
site_domain, site_urlгде сайт отвечает сейчас; null при detached
publishedfalse при detached: у сайта нет публичной публикации
server_ipадрес для A-записей
server_ips, cloudflare_ipsмассивы строк с адресами сервера и сетями Cloudflare для настройки DNS
free_domain_eligible, free_domain_claimedboolean: доступен ли бесплатный домен и был ли он уже получен
domain_displayисходное написание домена, если оно отличается от punycode
failed_stage, errorэтап и причина сбоя при status: failed
dns.records[]что прописать: type, host (полное имя записи), value; found — что отдают публичные DNS сейчас, ok
dns.problems[]что помешает сертификату: aaaa_record (IPv6-запись), cloudflare_proxy (включен прокси Cloudflare), extra_a_record (лишний адрес рядом с адресом сервера)
started_at, elapsedначало подключения и секунды с него
previous_domainпрежний адрес платформы; сам по себе не включает возврат при DELETE без to
finishedadopt, cache, rebake — один раз после перевода
nextчто делать дальше, одной строкой

dns приходит, пока ждем записи, и после отказа на dns или cert. Вместо A-записи у www можно поставить CNAME на основной домен. Поля состояния перечислены для items[0]. У domain нет языковых вариантов.

Ошибки

КодHTTPКогдаЧто делать
lang_not_accepted400у домена нет языковых вариантовуберите lang из строки запроса и тела
source_auth_required403источник вызван без пользователя с правами на сайтпередайте токен администратора сайта
wrong_method_for_source405метод не поддерживает источник domainиспользуйте GET, PUT или DELETE
site_not_found404сайта нет или он не вашпроверьте site_id в GET /sites
domain_step_failed502 или статус шагапроверка или завершение подключения не удалисьисправьте причину из message и повторите
internal_unavailable502сервис подключения недоступенповторите позже

Отключить домен

DELETE /data/domain

Без поля to освобождает текущий адрес сайта и снимает его публичную публикацию. Данные, id сайта и права доступа сохраняются. Применяется и к собственному домену, и к адресу на onpress.pro. Освободившийся домен можно назначить другому своему сайту через PUT /data/domain.

curl -s -X DELETE "$API/site/$SITE/data/domain" -H "Authorization: Bearer $OP_TOKEN"

После освобождения в items[0] приходят mode: "release", status: "detached", domain: null, site_domain: null, site_url: null и published: false. Повторный DELETE возвращает changed: false. GET этого состояния не запускает подключение заново.

Чтобы вместо снятия публикации перевести сайт на конкретный адрес платформы, передайте to:

curl -s -X DELETE "$API/site/$SITE/data/domain" \
  -H "Authorization: Bearer $OP_TOKEN" -H 'Content-Type: application/json' \
  -d '{"to":"mysite.onpress.pro"}'

В этом режиме незавершенное подключение (pending_dns, failed) отменяется с mode: "cancel"; сайт остается на прежнем адресе. Не суперадмину в to доступен только прежний адрес платформы этого сайта, другой отклоняется 403 insufficient_role. Сайт на собственном домене возвращается на выбранный адрес платформы с mode: "move_back", status: "disconnecting", затем none. Домен снимается с сервера; записи DNS у регистратора удаляете вы.

Параметры пути. Сайт задает общий префикс /site/{siteId}; выбор сайта.

Параметры строки запроса

ПараметрТипОбязателенПо умолчаниюОписание
dry_runbooleanнетfalseпроверить отключение без записи; общие правила

Параметры тела

ПолеТипОбязателенПо умолчаниюОписание
tostringнет—свободный прямой адрес <name>.onpress.pro для режима возврата на адрес платформы; правила имени те же, что у PUT. Без to адрес освобождается и публикация снимается
dry_runboolнетfalseпоказать, что будет, ничего не меняя; можно и ?dry_run=1

Ответ

{
  "success": true,
  "site_id": "FJyyv3Xiv",
  "name": "domain",
  "origin": "system",
  "contextual": false,
  "writable": true,
  "write": {
    "method": "PUT",
    "methods": [
      "PUT",
      "DELETE"
    ],
    "at": "/data/domain",
    "forwards_to": "the existing domain connection service of the selected site",
    "dry_run": true,
    "body": "{\"domain\":\"example.com\",\"dry_run\"?:true} connects an external domain with the existing DNS and certificate lifecycle, or renames the platform address to a free non-reserved <name>.onpress.pro hostname",
    "changes": "the custom domain of the selected site; DNS, certificate and switching status are returned in items[0]",
    "delete": {
      "method": "DELETE",
      "dry_run": true,
      "body": "without to: release the domain and take the retained site offline; {\"to\":\"mysite.onpress.pro\",\"dry_run\"?:true} keeps the address-change flow"
    }
  },
  "total": 1,
  "items": [
    {
      "mode": "release",
      "status": "detached",
      "domain": null,
      "site_domain": null,
      "site_url": null,
      "published": false,
      "next": "PUT /data/domain with a domain to publish the retained site again"
    }
  ],
  "dry_run": false,
  "changed": true,
  "applied": true,
  "source": "domain"
}

Ошибки

КодHTTPКогдаЧто делать
lang_not_accepted400у домена нет языковых вариантовуберите lang из строки запроса и тела
source_auth_required403источник вызван без пользователя с правами на сайтпередайте токен администратора сайта
wrong_method_for_source405метод не поддерживает источник domainиспользуйте GET, PUT или DELETE
invalid_to400to не адрес в зоне onpress.proпередайте адрес вида mysite.onpress.pro
invalid_platform_domain400to вложенный, зарезервированный или не подходит по правилам адреса платформыпередайте свободный прямой адрес вида my-site.onpress.pro
unknown_field400в теле лишнее полеоставьте to и dry_run
site_not_found404сайта нет или он не вашпроверьте {id}
domain_taken409адрес to занятвыберите другой
domain_busy409идет подключение домена, переезд или обновление публикации; освобождение адреса пока недоступнозавершите или отмените текущее подключение и повторите запрос
main_site_locked, wrong_realm409как у PUTпроверьте параметр из message и повторите запрос
internal_unavailable502шаг не выполнилсяповторите запрос
domain_publisher_missing, domain_storage_failed503снятие публикации или сохранение изменения адреса не завершилосьповторите позже; при повторном отказе передайте код и id сайта в поддержку
arrow_backНазад
Кэш
Далееarrow_forward
Общие правила
На этой странице
  • Подключить домен
    • Параметры строки запроса
      • Параметры тела
        • Ответ
          • Ошибки
        • Получить статус подключения
          • Ответ
            • Ошибки
          • Отключить домен
            • Параметры строки запроса
              • Параметры тела
                • Ответ
                  • Ошибки
                1. Главная
                2. Docs
                3. Документация OnPress v2
                4. Справочник API
                5. Домен
                © 2026 OnPress ИП Зуев И.В. ИНН: 360408359441 info@onpress.pro Политика конфиденциальности Публичная оферта
                • Visa
                • Mastercard
                • Сбер Pay
                • T-Pay