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

Чтение блока страницы

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

Возвращает только объявленные метаданные блока. Блок должен принадлежать pageId; блок другой страницы даёт 404. Всегда используется params.edit_mode=1, поэтому черновики видны. Даты представлены как ISO wall clock без выдуманного часового пояса.

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

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

Поле Тип Обязательно Описание
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" \
  -H "X-Api-Key: YOUR_API_KEY"

curl — OAuth application

Terminal 
curl "https://vibecode.bitrix24.tech/v1/pages/20/blocks/30" \
  -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", {
  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", {
  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.id integer ID блока.
data.pageId integer ID страницы блока.
data.code string Код блока.
data.name string Название блока.
data.active boolean Блок активен в черновике.
data.dateCreate string or null ISO wall clock без выдуманного часового пояса.
data.dateModify string or null ISO wall clock без выдуманного часового пояса.
data.createdById integer or null ID создателя.
data.modifiedById integer or null ID последнего редактора.

Ответ

JSON 
{
  "success": true,
  "data": {
    "id": 30,
    "pageId": 20,
    "code": "01.big_with_text_3",
    "name": "Example",
    "active": true,
    "dateCreate": "2026-10-05T14:41:37",
    "dateModify": "2026-10-05T14:41:37",
    "createdById": 42,
    "modifiedById": 42
  }
}

Ошибки

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.

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

См. также