Для AI-агентов: markdown этой страницы — /docs-content/entities/pages/block-content.md индекс документации — /llms.txt

Чтение содержимого блока

GET /v1/pages/:pageId/blocks/:blockId/content

Всегда используется editMode=1. html содержит разметку с контейнером block-wrapper. Необязательные anchor, nodes, cards, style, attrs, css, js и php возвращаются, если их передал Б24; полный manifest не возвращается. php=true означает блок с кодом, правка содержимого ограничена.

Требуется scope landing. READONLY-ключ может читать. Необязательный query scope=KNOWLEDGE|GROUP|MAINPAGE выбирает контекст страницы. Тело контрактом не предусмотрено. Строки с credential URL заменяются на [REDACTED], при необходимости целиком HTML. Ответ Б24 ограничен 8 MiB; превышение даёт 502.

Если данные редактирования отсутствуют на верхнем уровне, nodes, cards, style и attrs берутся из соответствующих полей манифеста. Б24 может возвращать пустые словари как пустые массивы.

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

Поле Тип Обязательно Описание
pageId integer yes Положительный безопасный ID страницы из списка страниц.
blockId integer yes Положительный безопасный ID блока этой страницы.
scope string no KNOWLEDGE, GROUP или MAINPAGE; для обычного сайта опускается.

Примеры

curl — personal key

Terminal 
curl "https://vibecode.bitrix24.tech/v1/pages/20/blocks/30/content" \
  -H "X-Api-Key: YOUR_API_KEY"

curl — OAuth application

Terminal 
curl "https://vibecode.bitrix24.tech/v1/pages/20/blocks/30/content" \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN"

JavaScript — personal key

javascript 
const response = await fetch("https://vibecode.bitrix24.tech/v1/pages/20/blocks/30/content", {
  headers: {"X-Api-Key": "YOUR_API_KEY"},
})
const result = await response.json()
if (!response.ok) throw new Error(result.error.message)
console.log(result.data)

JavaScript — OAuth application

javascript 
const response = await fetch("https://vibecode.bitrix24.tech/v1/pages/20/blocks/30/content", {
  headers: {"X-Api-Key": "YOUR_APP_KEY", "Authorization": "Bearer USER_SESSION_TOKEN"},
})
const result = await response.json()
if (!response.ok) throw new Error(result.error.message)
console.log(result.data)

Поля ответа

Поле Тип Описание
success boolean true
data object Результат операции.
data.html string HTML с block-wrapper; может быть [REDACTED].
data.anchor string Необязательный якорь.
data.nodes object or array Необязательные данные узлов или словарь селекторов манифеста.
data.cards object or array Необязательные данные карточек или словарь селекторов манифеста.
data.style object or array Необязательные данные стилей.
data.attrs object or array Необязательные данные атрибутов.
data.css array Необязательные ресурсы CSS.
data.js array Необязательные ресурсы JavaScript.
data.php boolean Необязательно; true означает ограничение правки содержимого.

Ответ

JSON 
{
  "success": true,
  "data": {
    "html": "<section>Example</section>",
    "anchor": "example",
    "nodes": {},
    "cards": {},
    "style": {},
    "attrs": {},
    "css": [],
    "js": [],
    "php": false
  }
}

Ошибки

HTTP Код Условие
400 INVALID_PARAMS Некорректный pageId/blockId или пустой code.
400 INVALID_SCOPE Некорректный scope.
401 TOKEN_MISSING Нет авторизации Б24.
403 SCOPE_DENIED У ключа нет scope landing.
403 BITRIX_ACCESS_DENIED Нет прав у пользователя Б24.
404 ENTITY_NOT_FOUND Блок другой страницы, нет образца или файла манифеста.
409 LANDING_MODULE_NOT_ENABLED Модуль «Сайты» недоступен на портале.
422 BITRIX_ERROR Бизнес-отказ Б24; текст сохраняется.
502 BITRIX_INVALID_RESPONSE Неожиданный результат или ответ Б24 больше 8 MiB.

Все системные ошибки.

См. также