Эффективная интеграция и кастомизация функционала в Битрикс24 часто требует работы на уровне API. Сегодня мы подробно рассмотрим «Добавить страницу по шаблону landing.landing.addByTemplate». Вы узнаете экспертные методики работы с landing.landing.addByTemplate и научитесь избегать типичных ошибок начинающих разработчиков.

Добавить страницу по шаблону landing.landing.addByTemplate

Тут может не хватать некоторых данных — дополним в ближайшее время

• не указаны типы параметров
• не указана обязательность параметров
• отсутствуют примеры
• отсутствует ответ в случае успеха
• отсутствует ответ в случае ошибки

> Scope: landing
>
> Кто может выполнять метод: любой пользователь

Метод landing.landing.addByTemplate добавляет страницу по шаблону (список шаблонов, который видит пользователь перед созданием страницы). Возвращает ID созданной страницы или ошибку.

Вы не можете влиять на поля создаваемой страницы, для этого вам поможет landing.landing.add.

Входящие параметры и конфигурация метода

Практические примеры использования в коде

• JS

    try
    {
    	const response = await $b24.callMethod(
    		'landing.landing.addByTemplate',
    		{
    			siteId: 870,
    			code: 'agency',
    			fields: {
    				TITLE: 'Заголовок страницы',
    				DESCRIPTION: 'Описание страницы'
    			}
    		}
    	);
    	
    	const result = response.getData().result;
    	if(result.error())
    	{
    		console.error(result.error());
    	}
    	else
    	{
    		console.info(result);
    	}
    }
    catch(error)
    {
    	console.error('Error:', error);
    }

• PHP

    try {
        $response = $b24Service
            ->core
            ->call(
                'landing.landing.addByTemplate',
                [
                    'siteId' => 870,
                    'code' => 'agency',
                    'fields' => [
                        'TITLE' => 'Заголовок страницы',
                        'DESCRIPTION' => 'Описание страницы'
                    ]
                ]
            );
    
        $result = $response
            ->getResponseData()
            ->getResult();
    
        if ($result->error()) {
            error_log($result->error());
        } else {
            echo 'Success: ' . print_r($result->data(), true);
        }
    
    } catch (Throwable $e) {
        error_log($e->getMessage());
        echo 'Error adding landing by template: ' . $e->getMessage();
    }

• BX24.js

    BX24.callMethod(
        'landing.landing.addByTemplate',
        {
            siteId: 870,
            code: 'agency',
            fields: {
                TITLE: 'Заголовок страницы',
                DESCRIPTION: 'Описание страницы'
            }
        },
        function(result)
        {
            if(result.error())
                console.error(result.error());
            else
                console.info(result.data());
        }
    );