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

Показать блок

POST /v1/pages/:pageId/blocks/:blockId/show

Показывает блок в черновике. Повтор успешен. На публичном сайте изменение видно после публикации страницы.

Требуется скоуп landing. READONLY-ключ получает 403 до обращения к Б24. Правится черновик.

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

Поле Тип Обяз. Описание
pageId integer да Исходная страница из списка страниц.
blockId integer да Блок исходной страницы. ID можно взять из ответа copy/move.
scope string нет Query: KNOWLEDGE, GROUP, MAINPAGE; для обычных сайтов не нужен.

Примеры

curl — личный ключ

Terminal 
curl -X POST "https://vibecode.bitrix24.tech/v1/pages/42/blocks/31/show" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

curl — OAuth-приложение

Terminal 
curl -X POST "https://vibecode.bitrix24.tech/v1/pages/42/blocks/31/show" \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

JavaScript — личный ключ

javascript 
const response = await fetch("https://vibecode.bitrix24.tech/v1/pages/42/blocks/31/show", {
  method: "POST",
  headers: { "X-Api-Key": "YOUR_API_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({})
});
const result = await response.json();

JavaScript — OAuth-приложение

javascript 
const response = await fetch("https://vibecode.bitrix24.tech/v1/pages/42/blocks/31/show", {
  method: "POST",
  headers: { "X-Api-Key": "YOUR_APP_KEY", "Authorization": "Bearer USER_SESSION_TOKEN", "Content-Type": "application/json" },
  body: JSON.stringify({})
});
const result = await response.json();

Поля ответа

Поле Тип Описание
success boolean Успешный ответ.
data object Результат операции.
data.active boolean Перечитанная видимость черновика.

Ответ

JSON 
{
  "success": true,
  "data": {
    "active": true
  }
}

Ошибки

HTTP Код Причина
400 INVALID_PARAMS Некорректный ID, тело или блок после которого вставлять.
400 MISSING_REQUIRED_FIELDS Нет обязательного поля.
403 SCOPE_DENIED / WRITE_BLOCKED_READONLY_KEY Нет landing или ключ только для чтения.
409 LANDING_MODULE_NOT_ENABLED Модуль Сайты недоступен на портале.
404 ENTITY_NOT_FOUND Нет страницы или блок не принадлежит исходной странице.
422 BITRIX_ERROR / BITRIX_NO_EFFECT Отказ Б24 или результат не подтверждён; не повторяйте удаление вслепую.

Общие ошибки.

Каждый ответ Б24 ограничен 8 МиБ; превышение даёт 502. После неподтверждённого результата не повторяйте действие вслепую: copy может создать ещё один блок, up/down изменят порядок повторно.