Токен REST

Результат: внешний сайт читает опубликованные страницы по Bearer. Запись страниц этим токеном недоступна. Нужен PageBuilder Pro. Free Public API (api.php) остаётся отдельно.

Что нужно заранее

1. Включена pagebuilder_rest_api_enabled.
2. PageBuilder Pro установлен. Токен выпускают во вкладке API tokens.

Шаги

1. В CMP API tokens выпустите токен. Секрет показывают один раз. В настройке pagebuilder_rest_tokens остаются prefix и hash.
2. Отметьте scopes pages.read и, если нужен каталог типов, catalog.read.
3. Запрос:

GET /assets/components/pagebuilder/api/v1.php?path=/pages/42
Authorization: Bearer <secret>

Scope	Маршруты
pages.read	GET /pages, GET /pages/{id-or-alias}
catalog.read	GET /health, GET /catalog/sections

Список страниц не содержит тело документа. Повтор с If-None-Match отвечает 304.

GET /openapi.json на том же v1.php не требует Bearer. Без токена спецификация строится со scopes catalog.read и pages.read. Секрет токена в неё не входит. Нужны включённый REST и Pro, иначе ответ 404.

Отозванный токен отвечает 401. Лимит pagebuilder_rest_throttle_per_minute (по умолчанию 120) при превышении отвечает 429 и Retry-After.

Пример полей

Подставьте id или alias опубликованного ресурса.

Scope только pages.read: GET /pages/42 возвращает документ, GET /catalog/sections без catalog.read недоступен. Оба scope: каталог типов открывается тем же Bearer.

Что проверить

Первый запрос с секретом отвечает телом страницы и заголовком ETag. Повтор с If-None-Match отвечает 304. После отзыва тот же секрет отвечает 401.

Откат

Отзовите токен во вкладке API tokens.

См. также

• REST API v1
• Public API