Справочник: настройки, главная, кэш

Ручки сайта: $API/site/$SITE/settings, /front-page, /cache/flush. Записи выполняются ядром WordPress на домене сайта. Подробно — настройки, главная и кэш.

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

Пункт	Ручка	Тело
Сравнить периоды по всему сайту	`GET /site/SITE_ID/content-stats?period=week`	—

Сравнение завершённых периодов

Ручка отдаёт сохранённый ночной снимок Google Analytics 4 и сама не обращается к Google. Поэтому открытие раздела «Статистика», переход по ссылке и смена периода не запускают новый сбор. Права — администратор сайта или суперадмин; поддерживаются только сайты OnPress v2.

Параметр period: yesterday — вчера и позавчера, week — последние 7 полных дней и предшествующие 7, month — последние 30 полных дней и предшествующие 30. По умолчанию week. Сегодняшние неполные сутки не входят в сравнение. Это скользящие периоды, не календарные недели или месяцы.

Ответ содержит success, stored: true, period, updated_at и единственный источник sources.ga. У него есть status, message, timezone, updated_at, completeness, windows, current, previous, events, events_kind и events_status. windows.current и windows.previous — включительные даты from и to в часовом поясе ресурса GA4.

current и previous содержат показатели всего ресурса: visits — уникальные пользователи, sessions — сеансы, organic — сеансы канала Organic Search, bounce — отказы в процентах, time — средняя длительность сеанса в секундах, events — число событий. Каждый показатель — число или null; ноль не означает отсутствие доступа. При нуле сеансов среднее время и доля отказов — null.

events — объединённый по двум периодам массив {name, current, previous}. events_status: ok означает, что список получен полностью, unavailable — недоступен, error — сбор списка завершился ошибкой. Ошибка списка событий не стирает успешно собранные общие показатели.

curl -s -H "Authorization: Bearer $OP_TOKEN" \
  "$API/site/$SITE/content-stats?period=week"

Отказы: 400 invalid_period — неизвестный период; 404 content_stats_pending — ночной снимок ещё не собран; 409 v2_site_required — сайт первой версии. Ответ помечен Cache-Control: private, no-store.

GET /settings

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

{
  "success": true,
  "site_id": "x9HTLHECq",
  "settings": {
    "blogname": "Test",
    "blogdescription": "Multipress website",
    "blog_public": 1,
    "blogs_public": 1,
    "site_icon": 4827,
    "site_icon_url": "https://test.onpress.pro/wp-content/uploads/sites/233/2025/02/cropped-6sdc-2.png",
    "analytics": { "ym_counter_id": "", "ym_enabled": 0, "ga_measurement_id": "", "ga_enabled": 0, "gsc_verified": 0, "…": "…" },
    "domain": "test.onpress.pro",
    "template": "onpress-v2",
    "stylesheet": "onpress-v2",
    "show_on_front": "page",
    "page_on_front": 5776
  }
}

PATCH /settings

Поле	Тип	Смысл
`blogname`	string	название, не пустое
`blogdescription`	string	описание
`blog_public`	0/1 или bool	видимость для поисковиков (опция сайта и реестр сети)
`site_icon`	int	id картинки медиатеки; `0` снимает
`analytics`	object	публичные ключи счётчиков: `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_host_id`, `ywm_client_site_url`, `ywm_client_verification_token`, `ywm_client_verified`, `ywm_client_login`, `ywm_client_user_id`, `ywm_client_connected_at`. Секрет `ywm_client_token` не принимается (`400 secret_field`) и не отдаётся ни в `GET`, ни в ответе `PATCH`

curl -s -X PATCH "$API/site/$SITE/settings" \
  -H "Authorization: Bearer $OP_TOKEN" -H 'Content-Type: application/json' \
  -d '{"blogdescription": "Multipress website (проба)"}'

{
  "success": true,
  "site_id": "x9HTLHECq",
  "changed": ["blogdescription"],
  "settings": { "…": "…" },
  "cache": {
    "polylang": { "transients": ["pll_languages_list", "pll_translated_slugs"], "model_cache": true },
    "object": true,
    "supercache": { "status": "flushed", "dirs": ["…/supercache/test.onpress.pro"] }
  }
}

Отказы: 400 unknown_field (со списком допустимых), 400 invalid_blogname и другие invalid_<поле>, 400 invalid_site_icon, 400 invalid_analytics (неизвестный ключ, допустимые в allowed), 400 secret_field (секретный ключ в analytics, имена в fields), 400 nothing_to_change, 502 internal_unavailable.

PUT /front-page

Поле	Смысл
`page`	id или путь страницы
`lang`	язык страницы, если путь есть в нескольких языках

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

{
  "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/" }
  },
  "polylang_redirect_lang": true,
  "before": { "show_on_front": "page", "page_on_front": 5776 },
  "cache": { "…": "…" }
}

На многоязычном сайте записывается страница основного языка из группы переводов присланной; главные остальных языков — её переводы (front_pages). Отказы: 400 invalid_page, 400 invalid_lang, 404 page_not_found, 409 no_default_translation (у страницы нет перевода на основной язык), 409 page_not_published (главной может быть только опубликованная страница).

POST /cache/flush

Поле	Смысл
`urls`	адреса (путь или полный) — сбросить их копии и копии разбивки
`pages`	id страниц — то же
`supercache`	`true` — весь кэш страниц сайта
`object`	`true` — объектный кэш
`polylang`	`true` — кэш языков и переведённых слагов
`transients`	имена временных записей; `имя*` — по началу

curl -s -X POST "$API/site/$SITE/cache/flush" \
  -H "Authorization: Bearer $OP_TOKEN" -H 'Content-Type: application/json' \
  -d '{"urls": ["/docs/", "/ru/docs-ru/"], "pages": [6186], "transients": ["pll_languages_list"]}'

{
  "success": true,
  "site_id": "x9HTLHECq",
  "flushed": {
    "transients": { "deleted": ["pll_languages_list"], "missing": [] },
    "urls": {
      "status": "flushed",
      "by": "wpsc_delete_url_cache",
      "urls": ["https://test.onpress.pro/docs/vvedenie/", "/docs/", "/ru/docs-ru/"],
      "skipped": [],
      "dirs": ["…/supercache/test.onpress.pro"]
    }
  }
}

status: flushed, empty, failed. skipped — адреса со строкой запроса (не кэшируются). Отказы: 400 nothing_to_flush, 400 invalid_transients, 400 invalid_pages, 400 invalid_urls.