• Быстрый старт
    • Демо
  • УСТРОЙСТВО
    • Страницы
      • 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 читает и меняет настройки сайта и назначает главную страницу. Сценарии — в гайде.

info

API — https://onpress.pro/api/v2, SITE — id сайта, OP_TOKEN — токен op_XXXX. Пути на этой странице начинаются с $API/site/$SITE. Токен и права — в «Авторизации», общий формат — в «Общих правилах».

Эндпоинты

МетодПутьДействие
GET/data/site.settingsПрочитать настройки сайта
PATCH/data/site.settingsИзменить настройки сайта
GET/data/settingsПрочитать поля настроек
GET/data/settings/{field}Прочитать поле настроек
PUT/data/settings/{field}Изменить поле настроек
GET/data/site.front_pageПрочитать главную страницу
PUT/data/site.front_pageНазначить главную страницу

Прочитать настройки сайта

GET /data/site.settings

Отдает настройки сайта одной записью в items. Подробнее в гайде.

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

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

Ответ

{
  "success": true,
  "site_id": "x9HTLHECq",
  "name": "site.settings",
  "origin": "system",
  "writable": true,
  "write": { "method": "PATCH", "at": "/data/site.settings", "…": "…" },
  "total": 1,
  "items": [{
    "name": "Test",
    "description": "",
    "home_url": "https://test.onpress.pro",
    "site_url": "https://test.onpress.pro",
    "admin_email": "admin@example.com",
    "timezone": "UTC-5",
    "date_format": "d.m.Y",
    "time_format": "H:i",
    "locale": "en_US",
    "charset": "UTF-8",
    "posts_per_page": 12,
    "blog_public": 1,
    "show_on_front": "page",
    "front_page_id": 5776,
    "posts_page_id": 0,
    "theme": "onpress-v2"
  }]
}
ПолеТипОписание
namestringназвание сайта
descriptionstringописание сайта; идет в разметку WebSite
home_url, site_urlstringадрес сайта без косой черты на конце
admin_emailstringпочта администратора
timezonestringчасовой пояс: имя зоны или UTC+N
date_format, time_formatstringформаты даты и времени
localestringлокаль сайта
charsetstringкодировка
posts_per_pagenumberсколько элементов на странице списка
blog_publicnumber1 — сайт открыт поисковикам, 0 — закрыт
show_on_front, front_page_id, posts_page_idstring, numberчто открывается в корне: page и id страницы или posts
themestringтема сайта

Иконки в этой записи нет: ее отдает GET /data/settings/icon.

Ошибки

Общие коды — на странице «Ошибки».

Изменить настройки сайта

PATCH /data/site.settings

Меняет только присланные поля, остальные остаются как были. Подробнее в гайде.

curl -s -X PATCH "$API/site/$SITE/data/site.settings" \
  -H "Authorization: Bearer $OP_TOKEN" -H 'Content-Type: application/json' \
  -d '{"description": "Бесплатный ИИ-чат без регистрации"}'

Тело запроса

ПолеТипОбязательноеПо умолчаниюОписание
namestringнет—название; пустая строка — отказ
descriptionstringнет—описание сайта
blog_public0/1 или boolнет—открыт ли сайт поисковикам
site_iconintнет—id картинки медиатеки этого сайта; 0 снимает иконку
analyticsobjectнет—ключи счетчиков как есть: ym_counter_id, ym_enabled, ym_counter_name, ga_measurement_id, ga_property_id, ga_property_name, ga_enabled, gsc_verification_token, gsc_site_url, gsc_verified, ywm_host_id, ywm_site_url, ywm_verification_token, ywm_verified, ywm_client_* (только чтение). Подключать счетчики проще полями metrika, ga, gsc и webmaster — см. Аналитика

Ответ

{
  "success": true,
  "site_id": "x9HTLHECq",
  "changed": ["description"],
  "settings": { "name": "Test", "description": "Бесплатный ИИ-чат без регистрации", "blog_public": 1, "site_icon": 4827, "site_icon_url": "https://test.onpress.pro/…/icon.png", "analytics": { "…": "…" }, "domain": "test.onpress.pro", "show_on_front": "page", "page_on_front": 5776, "…": "…" },
  "cache": { "object": true, "supercache": { "status": "flushed" }, "…": "…" },
  "source": "site.settings",
  "rebaked": { "status": "ok", "total": 15, "baked": 15, "frames": ["…"] }
}

changed — записанные поля, settings — настройки после записи, cache — сброс кэшей, rebaked — пересборка фреймов, которые печатают название, иконку или адрес сайта. Проверки без записи у этого эндпоинта нет: dry_run — отказ.

Ошибки

КодHTTPКогдаЧто делать
nothing_to_change400в теле нет ни одного поляпришлите хотя бы одно поле
unknown_field400поле вне списка; допустимые — в messageуберите поле
field_belongs_elsewhere400поле только читается здесь: show_on_front, front_page_id, posts_page_id, locale, home_url, site_url, theme; куда идти — в fieldsглавная — PUT /data/site.front_page, язык — PATCH /data/site.languages, адрес — свой домен PUT /data/domain; тему API не меняет
invalid_name, invalid_description400не строкапришлите строку
invalid_site_icon400не целое число или такой картинки на сайте нетвозьмите id из GET /media
invalid_analytics400analytics не объект или незнакомый ключ; допустимые — в allowedисправьте ключи
secret_field400в analytics прислан секрет, например ywm_client_token; имена в fieldsсекрет ставит вход в Вебмастер из консоли, снимает PUT /data/settings/webmaster с null
dry_run_not_supported400прислан dry_runпрочитайте текущее значение через GET
wrong_method_for_source405PUT вместо PATCHотправьте PATCH
system_source_not_deletable409DELETEнастройки не удаляются, только меняются
internal_unavailable502сайт не ответилповторите запрос

Прочитать поля настроек

GET /data/settings

Отдает основные настройки по полям: у каждого поля свое значение и свой адрес записи. Подробнее в гайде.

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

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

Ответ

{
  "success": true,
  "site_id": "x9HTLHECq",
  "settings": {
    "name": "Test",
    "icon": 4827,
    "closed": false,
    "front_page": 5776,
    "languages": [
      { "slug": "en", "locale": "en_US", "name": "English", "default": true, "front_page": 5776, "url": "https://test.onpress.pro/" },
      { "slug": "ru", "locale": "ru_RU", "name": "Русский", "default": false, "front_page": 6037, "url": "https://test.onpress.pro/ru/" }
    ],
    "metrika": "12345678",
    "ga": "G-XXXXXXX",
    "gsc": null,
    "webmaster": null
  },
  "details": {
    "icon": { "url": "https://test.onpress.pro/…/icon.png" },
    "closed": { "supported": true, "reason": null, "retry_after": 3600 },
    "front_page": { "show_on_front": "page", "title": "home", "url": "/", "languages": { "en": 5776, "ru": 6037 } },
    "languages": { "default": "en" },
    "metrika": { "enabled": true, "name": "Test", "open_url": "https://metrika.yandex.ru/dashboard?id=12345678", "auto_available": true, "data": null },
    "…": "…"
  },
  "fields": { "name": { "method": "PUT", "at": "/data/settings/name", "body": "{\"value\": …}", "forwards_to": "PATCH /data/site.settings {\"name\"}" }, "…": "…" }
}

settings — поле и его значение, details — что прилагается к значению, fields — как поле пишется. Одно поле — GET /data/settings/{field}: ответ field, value, поля из details и write.

Полеvalue при чтенииРядом
nameназвание сайта—
iconid картинки, 0 — иконки нетurl
closedtrue — сайт закрыт для посетителей; null, если режим недоступенsupported, reason (not_v2, main_site), retry_after
front_pageid главной, 0 — в корне лента записейshow_on_front, title, url, languages — {язык: id} главной каждого языка
languages[{slug, locale, name, default, front_page, url}], только чтениеdefault
metrika, ga, gsc, webmasterномер счетчика, measurement ID, код тега, id сайта в Вебмастересм. Аналитика

Ошибки

КодHTTPКогдаЧто делать
unknown_settings_field404такого поля нет; список — в fieldsвозьмите поле из списка
wrong_method_for_settings405метод, кроме GET и PUT, или PUT /data/settings без поляпишите по одному полю

Прочитать поле настроек

GET /data/settings/{field}

Возвращает значение одного поля и сведения о его записи. Подробнее в гайде.

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

Параметры пути

ПолеТипОбязательноеПо умолчаниюОписание
fieldstringда—Идентификатор ресурса.

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

field — name, icon, closed, front_page, languages, metrika, ga, gsc, webmaster.

Ответ

{"success":true,"site_id":"SITE_ID","field":"name","value":"Example","write":{"method":"PUT","at":"/data/settings/name","body":"{\"value\": …}"}}

Поля ответа — field, value, write и дополнительные сведения поля из списка настроек.

Ошибки

КодHTTPКогдаЧто делать
unknown_settings_field404Поля нет.Возьмите имя из списка.

Изменить поле настроек

PUT /data/settings/{field}

Записывает одно поле телом {"value": …}. Подробнее в гайде.

curl -s -X PUT "$API/site/$SITE/data/settings/closed" \
  -H "Authorization: Bearer $OP_TOKEN" -H 'Content-Type: application/json' \
  -d '{"value": true}'

Параметры пути

ПолеТипОбязательноеПо умолчаниюОписание
fieldstringда—Идентификатор ресурса.

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

Тело запроса

ПолеТипОбязательноеПо умолчаниюОписание
valuestring, number, boolean или nullда—Значение выбранного поля. Допустимые значения — в таблице ответа ниже.
langstringнет—Язык страницы для поля front_page.

Ответ

{
  "success": true,
  "site_id": "x9HTLHECq",
  "field": "closed",
  "value": true,
  "supported": true,
  "reason": null,
  "retry_after": 3600,
  "write": { "method": "PUT", "at": "/data/settings/closed", "…": "…" },
  "changed": true,
  "cache": { "…": "…" },
  "forwards_to": "the closed mode of the site, through the executor of the site settings",
  "rebaked": { "status": "ok", "…": "…" }
}
ПолеЧто принимает value
nameнепустая строка, пробелы по краям срезаются
iconid картинки медиатеки этого сайта; 0 или null снимает иконку. Иконка — это favicon и логотип организации в разметке
closedtrue закрывает сайт, false открывает
front_pageid или путь опубликованной страницы; на многоязычном сайте рядом с value — lang, язык страницы
metrika, ga, gsc, webmasterсм. Аналитика

Ответ — поле после записи в форме чтения, плюс changed — изменилось ли что-то, cache, forwards_to — эндпоинт или исполнитель, который сделал запись, и rebaked: фреймы, которые печатают название, иконку или главную, пересобираются; при changed: false — rebaked.status: "nothing". Поле languages здесь только читается, языки меняет PATCH /data/site.languages.

Закрытый сайт отвечает посетителям 503 с заглушкой «сайт на обслуживании», Retry-After: 3600 и X-Robots-Tag: noindex; robots.txt отдает Disallow: /, карты сайта отвечают 503, llms.txt — 404, статические копии страниц снимаются, кэш сбрасывается. Вошедший администратор и API видят сайт как обычно. Свой robots.txt сохраняется и возвращается при открытии. Для сайта без поддержки режима API возвращает not_supported.

Ошибки

КодHTTPКогдаЧто делать
value_required400в теле нет valueпришлите {"value": …}
invalid_name400пустое название или не строкапришлите непустую строку
invalid_icon400не целое неотрицательное числопришлите id картинки
invalid_site_icon400картинки с таким id на сайте нетвозьмите id из GET /media
invalid_closed400не да/нетпришлите true или false
invalid_front_page400пусто или 0пришлите id или путь страницы
invalid_lang400неверный langвозьмите слаг из GET /data/site.languages
page_not_found404страницы нетпроверьте id или путь
unknown_settings_field404такого поля нетвозьмите поле из GET /data/settings
field_written_elsewhere405запись в languagesязыки — PATCH /data/site.languages
not_supported409closed на сайте без поддержки режима—
main_site409closed на главном сайте сети—
page_not_published409главной делают черновикопубликуйте страницу
no_default_translation409у страницы нет перевода на основной языкпривяжите перевод через PATCH /data/translations

Прочитать главную страницу

GET /data/site.front_page

Возвращает текущую главную страницу одной записью. Подробнее в гайде.

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

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

Ответ

{"success":true,"site_id":"SITE_ID","name":"site.front_page","origin":"system","total":1,"items":[{"id":5776,"title":"Главная","slug":"home","status":"publish","show_on_front":"page","url":"/","real_url":"/home/"}]}

items[0] содержит id, show_on_front, title, slug, status, url и real_url. url равен /, real_url — собственный адрес страницы.

Ошибки

Общие коды — на странице «Ошибки».

Назначить главную страницу

PUT /data/site.front_page

Главная страница сайта: что открывается в корне. Подробнее в гайде.

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

Тело запроса

ПолеТипОбязательноеПо умолчаниюОписание
pageint или stringда—id или путь страницы, обязательно; принимается и {"items": [{"id": …}]} из ответа чтения
langstringнет—язык страницы, если путь есть в нескольких языках

Ответ

PUT ставит главной страницу по id или пути; на многоязычном сайте вместе с ней переезжают главные всех языков — это ее переводы.

{
  "success": true,
  "site_id": "x9HTLHECq",
  "changed": false,
  "show_on_front": "page",
  "page_on_front": 5776,
  "front_pages": {
    "en": { "id": 5776, "url": "https://test.onpress.pro/" },
    "ru": { "id": 6037, "url": "https://test.onpress.pro/ru/" }
  },
  "before": { "show_on_front": "page", "page_on_front": 5776 },
  "cache": { "…": "…" },
  "source": "site.front_page",
  "rebaked": { "status": "ok", "…": "…" }
}

GET отдает одну запись: id, show_on_front, title, slug, status, url (всегда /) и real_url — собственный адрес страницы. На многоязычном сайте записывается страница основного языка из группы переводов присланной, главные остальных языков — ее переводы (front_pages). Главная языка, у которой еще нет перевода, привязывается через PATCH /data/translations. Проверки без записи нет.

Ошибки

КодHTTPКогдаЧто делать
invalid_page400нет page или пустой путьпришлите id или путь
invalid_lang400неверный langвозьмите слаг из GET /data/site.languages
dry_run_not_supported400прислан dry_run—
page_not_found404страницы нетпроверьте id или путь
wrong_method_for_source405PATCH вместо PUTотправьте PUT
no_default_translation409у страницы нет перевода на основной языкпривяжите перевод
page_not_published409страница не опубликованаопубликуйте ее

Статистика контента

Сводку Google Analytics 4 отдает GET /data/content_stats.

arrow_backНазад
Меню
Далееarrow_forward
Сайты
На этой странице
  • Эндпоинты
    • Прочитать настройки сайта
      • Ответ
        • Ошибки
      • Изменить настройки сайта
        • Тело запроса
          • Ответ
            • Ошибки
          • Прочитать поля настроек
            • Ответ
              • Ошибки
            • Прочитать поле настроек
              • Параметры пути
                • Ответ
                  • Ошибки
                • Изменить поле настроек
                  • Параметры пути
                    • Тело запроса
                      • Ответ
                        • Ошибки
                      • Прочитать главную страницу
                        • Ответ
                          • Ошибки
                        • Назначить главную страницу
                          • Тело запроса
                            • Ответ
                              • Ошибки
                            • Статистика контента
                            1. Главная
                            2. Docs
                            3. Документация OnPress v2
                            4. Справочник API
                            5. Настройки сайта
                            © 2026 OnPress ИП Зуев И.В. ИНН: 360408359441 info@onpress.pro Политика конфиденциальности Публичная оферта
                            • Visa
                            • Mastercard
                            • Сбер Pay
                            • T-Pay