Получить список шаблонов для создания страниц landing.demos.getPageList

Выберите инструмент для разработки с AI-агентом:

  • используйте Битрикс24 Вайбкод, чтобы создать приложение для Битрикс24 по описанию задачи без знания языков программирования. Агент напишет код и разместит приложение на сервере без ручной настройки хостинга
  • используйте MCP-сервер, чтобы разрабатывать интеграцию через REST API в своем проекте. Агент будет обращаться к официальной REST-документации

Scope: landing

Кто может выполнять метод: пользователь с правом Просмотр в разделе Сайты

Метод landing.demos.getPageList получает список файловых демо-шаблонов страниц.

Параметры метода

Обязательные параметры отмечены *

Название
тип

Описание

type*
string

Тип шаблона.

Возможные значения:

  • page — шаблоны для страниц
  • store — шаблоны для магазинов
  • knowledge — шаблоны для баз знаний
  • group — шаблоны для групп
  • mainpage — шаблоны для главных страниц

filter
object

Объект формата:

{
            field_1: value_1,
            field_2: value_2,
            ...,
            field_n: value_n
        }

где:

  • field_n — поле фильтра
  • value_n — значение фильтра

Фильтрация применяется к полям верхнего уровня объекта шаблона.

Фильтровать можно по полям из раздела Тип шаблона страницы. Вложенные поля (например, DATA.*) в фильтре не учитываются

Примеры кода

Как использовать примеры в документации

Пример получения списка шаблонов страниц, где:

  • type — код набора шаблонов
  • filter — фильтр по полям шаблона страницы
curl -X POST \
          -H "Content-Type: application/json" \
          -d '{
            "type": "page",
            "filter": {
              "TYPE": "PAGE"
            }
          }' \
          "https://**put.your-domain-here**/rest/**user_id**/**webhook_code**/landing.demos.getPageList.json"
        
curl -X POST \
          -H "Content-Type: application/json" \
          -d '{
            "type": "page",
            "filter": {
              "TYPE": "PAGE"
            },
            "auth": "**put_access_token_here**"
          }' \
          "https://**put.your-domain-here**/rest/landing.demos.getPageList.json"
        
try
        {
        	const response = await $b24.callMethod(
        		'landing.demos.getPageList',
        		{
        			type: 'page',
        			filter: {
        				TYPE: 'PAGE'
        			}
        		}
        	);
        
        	console.info(response.getData().result);
        }
        catch (error)
        {
        	console.error(error);
        }
        
try {
            $response = $b24Service
                ->core
                ->call(
                    'landing.demos.getPageList',
                    [
                        'type' => 'page',
                        'filter' => [
                            'TYPE' => 'PAGE',
                        ],
                    ]
                );
        
            $result = $response
                ->getResponseData()
                ->getResult();
        
            echo 'Success: ' . print_r($result, true);
        } catch (Throwable $e) {
            error_log($e->getMessage());
            echo 'Error getting page demo list: ' . $e->getMessage();
        }
        
BX24.callMethod(
            'landing.demos.getPageList',
            {
                type: 'page',
                filter: {
                    TYPE: 'PAGE'
                }
            },
            function(result)
            {
                if (result.error())
                {
                    console.error(result.error());
                }
                else
                {
                    console.info(result.data());
                }
            }
        );
        
require_once('crest.php');
        
        $result = CRest::call(
            'landing.demos.getPageList',
            [
                'type' => 'page',
                'filter' => [
                    'TYPE' => 'PAGE',
                ],
            ]
        );
        
        echo '<pre>';
        print_r($result);
        echo '</pre>';

Обработка ответа

HTTP-статус: 200

{
            "result": {
                "empty": {
                    "ID": "empty",
                    "XML_ID": "empty",
                    "TYPE": ["PAGE", "KNOWLEDGE", "GROUP", "MAINPAGE"],
                    "TITLE": "Пустая страница",
                    "ACTIVE": true,
                    "PUBLICATION": false,
                    "LOCK_DELETE": false,
                    "AVAILABLE": true,
                    "SINGLETON": false,
                    "SECTION": [],
                    "DESCRIPTION": "Создайте собственный сайт с чистого листа и привлекайте клиентов!",
                    "PREVIEW": "//bitrix24.ru/bitrix/components/bitrix/landing.demo/data/page/empty/preview.jpg",
                    "PREVIEW2X": "//bitrix24.ru/bitrix/components/bitrix/landing.demo/data/page/empty/preview@2x.jpg",
                    "PREVIEW3X": "//bitrix24.ru/bitrix/components/bitrix/landing.demo/data/page/empty/preview@3x.jpg",
                    "APP_CODE": "",
                    "REST": 0,
                    "DATA": {
                        "name": "Пустая страница",
                        "active": true,
                        "type": ["PAGE", "KNOWLEDGE", "GROUP", "MAINPAGE"],
                        "items": [],
                        "version": 1,
                        "old_id": 402,
                        "encoded": true,
                        "charset": "UTF-8"
                    }
                },
                "search-result": {
                    "ID": "search-result",
                    "XML_ID": "search-result",
                    "TYPE": ["PAGE", "KNOWLEDGE", "GROUP"],
                    "TITLE": "Результаты поиска",
                    "ACTIVE": false,
                    "PUBLICATION": true,
                    "SECTION": ["dynamic"],
                    "DATA": {
                        "code": "search-result",
                        "section": ["dynamic"],
                        "publication": true,
                        "layout": [],
                        "items": {
                            "#block3430": {
                                "code": "59.1.search"
                            }
                        },
                        "encoded": true,
                        "charset": "UTF-8"
                    }
                }
            },
            "time": {
                "start": 1774625365,
                "finish": 1774625365.92986,
                "duration": 0.9298601150512695,
                "processing": 0,
                "date_start": "2026-03-27T18:29:25+03:00",
                "date_finish": "2026-03-27T18:29:25+03:00",
                "operating_reset_at": 1774625965,
                "operating": 0
            }
        }

Возвращаемые данные

Название
тип

Описание

result
object | array

Карта демо-шаблонов страниц в формате:

{
            "template_code": page_template
        }

где:

  • template_code — код шаблона
  • page_template — объект шаблона страницы подробнее

Если подходящих шаблонов нет, метод возвращает пустой массив result: [] без ошибки.

Состав полей шаблонов может отличаться и зависит от конкретного шаблона

time
time

Информация о времени выполнения запроса

Тип шаблона страницы

Название
тип

Описание

ID
string

Идентификатор шаблона

XML_ID
string

Внешний код шаблона

TYPE
string[] | string

Типы, для которых доступен шаблон.

Для файловых шаблонов обычно возвращается массив, для зарегистрированных шаблонов приложения — строка

TITLE
string

Название шаблона

ACTIVE
boolean

Признак активности

PUBLICATION
boolean

Признак доступности публикации

LOCK_DELETE
boolean

Признак запрета удаления

AVAILABLE
boolean

Признак доступности шаблона

SINGLETON
boolean

Признак одиночного шаблона

SECTION
string[]

Разделы шаблона

DESCRIPTION
string

Описание шаблона

PREVIEW
string

Preview 1x

PREVIEW2X
string

Preview 2x

PREVIEW3X
string

Preview 3x

APP_CODE
string

Код приложения

REST
integer

Признак REST-шаблона

DATA
object | array

Данные шаблона из файлового источника подробнее.

Для зарегистрированных шаблонов приложения может приходить пустой массив

Тип данных шаблона DATA

Название
тип

Описание

code
string

Код шаблона в данных экспорта

name
string

Название шаблона в данных экспорта

type
string[]

Типы шаблона.

Возможные значения:

  • page — шаблоны для страниц
  • store — шаблоны для магазинов
  • knowledge — шаблоны для баз знаний
  • group — шаблоны для групп
  • mainpage — шаблоны для главных страниц

description
string | null

Описание шаблона

active
boolean

Признак активности шаблона в данных экспорта

publication
boolean

Признак публикации шаблона в данных экспорта

singleton
boolean

Признак одиночного шаблона в данных экспорта

lock_delete
boolean

Признак запрета удаления в данных экспорта

preview
string

Preview 1x в данных экспорта

preview2x
string

Preview 2x в данных экспорта

preview3x
string

Preview 3x в данных экспорта

preview_url
string

Ссылка на предпросмотр в данных экспорта

show_in_list
string

Признак показа в списке (Y/N)

sort
integer

Индекс сортировки шаблона

section
string[]

Разделы шаблона в данных экспорта

parent
string

Код родительского шаблона/сайта

disable_import
string

Флаг запрета импорта в данных шаблона (например Y)

is_webform_page
string

Флаг страницы с CRM-формой (например Y)

fields
object

Поля шаблона подробнее.

Коды fields.ADDITIONAL_FIELDS смотрите в разделе Дополнительные поля страницы

items
array | object

Состав шаблона подробнее

layout
array | object

Данные layout шаблона подробнее

folders
array | object

Папки шаблона подробнее

syspages
array | object

Системные страницы шаблона подробнее

master_pages
array

Список мастер-страниц шаблона подробнее

version
integer

Версия формата данных

old_id
integer | string

Исходный идентификатор (в зависимости от шаблона может приходить числом или строкой)

encoded
boolean

Добавляется методом со значением true, если в DATA есть поле items

charset
string

Добавляется методом со значением UTF-8, если в DATA есть поле items

Обработка ошибок

HTTP-статус: 400

{
            "error": "ERROR_ARGUMENT",
            "error_description": "The value of an argument 'filter' has an invalid type",
            "argument": "filter"
        }

Название
тип

Описание

error
string

Строковый код ошибки. Может состоять из цифр, латинских букв и знака подчеркивания

error_description
error_description

Текстовое описание ошибки. Описание не предназначено для показа конечному пользователю в необработанном виде

Возможные коды ошибок

Код

Описание

Значение

ERROR_ARGUMENT

The value of an argument 'filter' has an invalid type

Параметр filter передан в неверном типе

MISSING_PARAMS

Недостаточно параметров вызова

Не передан обязательный параметр type

ACCESS_DENIED

Недостаточно прав

Пользователь не прошел общие проверки доступа модуля Landing

TYPE_ERROR

Ошибка типа данных

Вызов метода с некорректным типом параметров

SYSTEM_ERROR

Внутренняя ошибка

Ошибка при выполнении метода на стороне сервера

Статусы и коды системных ошибок

HTTP-статус: 20x, 40x, 50x

Описанные ниже ошибки могут возникнуть при вызове любого метода

Статус

Код
Текст ошибки

Описание

500

INTERNAL_SERVER_ERROR
Internal server error

Возникла внутренняя ошибка сервера, обратитесь к администратору сервера или в техническую поддержку Битрикс24

500

ERROR_UNEXPECTED_ANSWER
Server returned an unexpected response

Возникла внутренняя ошибка сервера, обратитесь к администратору сервера или в техническую поддержку Битрикс24

503

QUERY_LIMIT_EXCEEDED
Too many requests

Превышен лимит на интенсивность запросов

429

OPERATION_TIME_LIMIT
Method is blocked due to operation time limit

Метод заблокирован из-за превышения лимита на ресурсоемкость запросов. Блокировка снимается автоматически через 10 минут

405

ERROR_BATCH_METHOD_NOT_ALLOWED
Method is not allowed for batch usage

Текущий метод не разрешен для вызова с помощью batch

400

ERROR_BATCH_LENGTH_EXCEEDED
Max batch length exceeded

Превышена максимальная длина параметров, переданных в метод batch

401

NO_AUTH_FOUND
Wrong authorization data

Неверный access-токен или код вебхука

400

INVALID_REQUEST
Https required

Для вызовов методов требуется использовать протокол HTTPS

503

OVERLOAD_LIMIT
REST API is blocked due to overload

REST API заблокирован из-за перегрузки. Это ручная индивидуальная блокировка, для снятия необходимо обращаться в техническую поддержку Битрикс24

403

ACCESS_DENIED
REST API is available only on commercial plans

REST API доступен только на коммерческих планах

403

INVALID_CREDENTIALS
Invalid request credentials

У пользователя, с чьим access-токеном или вебхуком был вызван метод, не хватает прав

404

ERROR_MANIFEST_IS_NOT_AVAILABLE
Manifest is not available

Манифест недоступен

403

insufficient_scope
The request requires higher privileges than provided by the webhook token

Запрос требует более высоких привилегий, чем предоставляет токен вебхука

401

expired_token
The access token provided has expired

Предоставленный access-токен доступа истек

403

user_access_error
The user does not have access to the application

Пользователь не имеет доступа к приложению. Это означает, что приложение установлено, но администратор портала разрешил доступ к этому приложению только конкретным пользователям

500

PORTAL_DELETED
Portal was deleted

Публичная часть сайта закрыта. Чтобы открыть публичную часть сайта на коробочной установке отключите опцию «Временное закрытие публичной части сайта». Путь к настройке: Рабочий стол > Настройки > Настройки продукта > Настройки модулей > Главный модуль > Временное закрытие публичной части сайта

Продолжите изучение

Предыдущая
Получить список шаблонов для создания сайтов
Следующая
Получить список зарегистрированных шаблонов