landing.block.changeNodeName
Изменить HTML-тег элемента блока
Описание
Метод landing.block.changeNodeName изменяет HTML-тег элемента блока в черновике страницы.
Если страница уже опубликована, изменения станут видны посетителям после повторной публикации через интерфейс или методом landing.landing.publication.
Параметры
scope
string
необязательный
Внутренний скоуп лендингов. Он не связан с REST-скоупом landing в названии метода.
Значение scope должно соответствовать типу сайта (подробное описание)
lid
integer
обязательный
Идентификатор страницы
Идентификатор страницы можно получить методом landing.landing.getList
block
integer
обязательный
Идентификатор блока в черновике страницы
Идентификатор блока можно получить методом landing.block.getlist с параметром params.edit_mode = 1.
Используйте идентификатор именно из черновика страницы. Если передать идентификатор блока из опубликованной версии или другой версии страницы, изменения не будут применены
data
object
обязательный
Набор изменений для элементов блока (подробное описание)
preventHistory
boolean
необязательный
Если передать true, метод не добавит действие в историю изменений страницы
По умолчанию false
Параметр data
<селектор>
string
необязательный
Новое имя HTML-тега для элемента, который указан в ключе
Ключ должен совпадать с селектором элемента из манифеста блока
Для повторяющихся элементов после селектора можно указать позицию через @, например .landing-block-node-title@1. Позиции нумеруются с 0
Если позицию не указать, метод изменит первый найденный элемент, то есть сработает так же, как @0
Если передать селектор, которого нет в манифесте блока, или указать позицию, которой нет в блоке, метод завершится без ошибки, но ничего не изменит
Допустимые значения тега
h1
необязательный
Заголовок первого уровня
h2
необязательный
Заголовок второго уровня
h3
необязательный
Заголовок третьего уровня
h4
необязательный
Заголовок четвертого уровня
h5
необязательный
Заголовок пятого уровня
h6
необязательный
Заголовок шестого уровня
div
необязательный
Блочный контейнер
p
необязательный
Абзац
a
необязательный
Ссылка
span
необязательный
Строчный контейнер
Примеры запроса
curl -X POST \
-H "Content-Type: application/json" \
-d '{
"lid": 311,
"block": 6058,
"data": {
".landing-block-node-title@0": "h1",
".landing-block-node-text@2": "p"
},
"preventHistory": true
}' \
"https://**put.your-domain-here**/rest/**user_id**/**webhook_code**/landing.block.changeNodeName.json"
curl -X POST \
-H "Content-Type: application/json" \
-d '{
"lid": 311,
"block": 6058,
"data": {
".landing-block-node-title@0": "h1",
".landing-block-node-text@2": "p"
},
"preventHistory": true,
"auth": "**put_access_token_here**"
}' \
"https://**put.your-domain-here**/rest/landing.block.changeNodeName.json"
// This snippet is an ES module: top-level await requires type="module" or a bundler.
// $b24 is an already-initialized SDK instance (see the SDK "Get started" guide).
import { Text } from '@bitrix24/b24jssdk'
import type { B24Frame } from '@bitrix24/b24jssdk'
declare const $b24: B24Frame
try {
const response = await $b24.actions.v2.call.make<boolean>({
method: 'landing.block.changeNodeName',
params: {
lid: 311,
block: 6058,
data: {
'.landing-block-node-title@0': 'h1',
'.landing-block-node-text@2': 'p',
},
preventHistory: true,
},
requestId: Text.getUuidRfc4122()
})
// The payload is available only on a successful response
if (!response.isSuccess) {
console.error(response.getErrorMessages().join('; '))
} else {
const result = response.getData()!.result
console.info('Node name changed:', result)
}
} catch (error) {
// Thrown on transport or SDK failures (AjaxError, SdkError, etc.)
console.error(error)
}
<!-- Load the SDK (UMD build); it is exposed as the global B24Js -->
<script src="https://unpkg.com/@bitrix24/b24jssdk@1/dist/umd/index.min.js"></script>
<script>
async function changeNodeName() {
try {
// Initialize the SDK inside a Bitrix24 frame
const $b24 = await B24Js.initializeB24Frame()
const response = await $b24.actions.v2.call.make({
method: 'landing.block.changeNodeName',
params: {
lid: 311,
block: 6058,
data: {
'.landing-block-node-title@0': 'h1',
'.landing-block-node-text@2': 'p',
},
preventHistory: true,
},
requestId: B24Js.Text.getUuidRfc4122()
})
// The payload is available only on a successful response
if (!response.isSuccess) {
console.error(response.getErrorMessages().join('; '))
return
}
const result = response.getData().result
console.info('Node name changed:', result)
} catch (error) {
// Thrown on transport or SDK failures (AjaxError, SdkError, etc.)
console.error(error)
}
}
document.addEventListener('DOMContentLoaded', changeNodeName)
</script>
from b24pysdk.errors import BitrixAPIError, BitrixSDKException
try:
bitrix_response = client.landing.block.change_node_name(
lid=311,
block=6058,
data={
".landing-block-node-title@0": "h1",
".landing-block-node-text@2": "p",
},
prevent_history=True,
).response
result = bitrix_response.result
print(result)
except BitrixAPIError as error:
print(
"Ошибка Bitrix API",
f"error: {error.error}",
f"error_description: {error.error_description}",
sep="\n",
)
except BitrixSDKException as error:
print(f"Ошибка Bitrix SDK: {error.message}")
except Exception as error:
print(f"Непредвиденная ошибка: {error}")
try {
$response = $b24Service
->core
->call(
'landing.block.changeNodeName',
[
'lid' => 311,
'block' => 6058,
'data' => [
'.landing-block-node-title@0' => 'h1',
'.landing-block-node-text@2' => 'p',
],
'preventHistory' => true,
]
);
$result = $response
->getResponseData()
->getResult();
echo 'Success: ' . var_export($result, true);
} catch (Throwable $e) {
error_log($e->getMessage());
echo 'Error changing node name: ' . $e->getMessage();
}
BX24.callMethod(
'landing.block.changeNodeName',
{
lid: 311,
block: 6058,
data: {
'.landing-block-node-title@0': 'h1',
'.landing-block-node-text@2': 'p'
},
preventHistory: true
},
function(result)
{
if (result.error())
{
console.error(result.error());
}
else
{
console.info(result.data());
}
}
);
require_once('crest.php');
$result = CRest::call(
'landing.block.changeNodeName',
[
'lid' => 311,
'block' => 6058,
'data' => [
'.landing-block-node-title@0' => 'h1',
'.landing-block-node-text@2' => 'p',
],
'preventHistory' => true,
]
);
if (isset($result['error']))
{
echo 'Ошибка: ' . $result['error_description'];
}
else
{
echo '<pre>';
print_r($result['result']);
echo '</pre>';
}
// client и ctx уже созданы — см. раздел «SDK для Go»
res, err := client.Core().Call(ctx, "landing.block.changeNodeName", b24.Params{
"lid": 311,
"block": 6058,
"data": b24.Params{
".landing-block-node-title@0": "h1",
".landing-block-node-text@2": "p",
},
"preventHistory": true,
})
if err != nil {
return fmt.Errorf("landing.block.changeNodeName: %w", err)
}
var ok bool
if err := json.Unmarshal(res.Result, &ok); err != nil {
return fmt.Errorf("разбор ответа: %w", err)
}
fmt.Println("выполнено:", ok)
Ответ
HTTP-статус: 200
{
"result": true,
"time": {
"start": 1774510990,
"finish": 1774510990.1045,
"duration": 0.10450005531311035,
"processing": 0,
"date_start": "2026-03-26T10:43:10+03:00",
"date_finish": "2026-03-26T10:43:10+03:00",
"operating_reset_at": 1774511590,
"operating": 0
}
}
Возвращаемые данные
result
boolean
Результат изменения тега. Если запрос выполнен успешно, метод возвращает true
time
time
Информация о времени выполнения запроса
Обработка ошибок
HTTP-статус: 400
{
"error": "ACCESS_DENIED",
"error_description": "Выполнение операции запрещено"
}
| Код | Описание | Значение |
|---|---|---|
MISSING_PARAMS |
Не передан обязательный параметр lid, block или data |
|
LANDING_NOT_EXIST |
Страница с идентификатором lid не найдена или недоступна текущему пользователю |
|
ACCESS_DENIED |
Недостаточно прав для редактирования сайта | |
BLOCK_NOT_FOUND |
Блок с идентификатором block не найден на странице lid или недоступен в версии страницы для редактирования |
|
NODES_NOT_FOUND |
В параметре data не передано ни одного изменения для блока |
|
TYPE_ERROR |
Передан неверный тип одного из параметров метода, например data в неподходящем формате |

