метод REST scope: landing

landing.repo.getList

Получить список пользовательских блоков

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

Описание

Метод landing.repo.getList получает список пользовательских блоков.

Параметры

params object необязательный

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

{
    select: value_1,
    filter: value_2,
    order: value_3,
    group: value_4,
    limit: value_5,
    offset: value_6
}

где:
- value_n — значение соответствующего параметра выборки

Подробнее о каждом параметре смотрите в разделе Параметр params

Параметр params

select string[] необязательный

Массив формата:

[
    field_1,
    field_2,
    ...,
    field_n
]

где:
- field_n — поле выборки

Список доступных полей для выборки смотрите в разделе Тип элемента result.

Элементы select со знаком . игнорируются

filter object необязательный

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

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

где:
- field_n — поле фильтрации
- value_n — значение фильтра

Список доступных полей для фильтрации смотрите в разделе Тип элемента result.

Если filter не передан или передан не в формате object, метод использует пустой фильтр {}

order object необязательный

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

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

где:
- field_n — поле сортировки
- value_n — направление сортировки: ASC или DESC

Список доступных полей для сортировки смотрите в разделе Тип элемента result

group array необязательный

Массив полей для группировки результата.

Формат:

[
    field_1,
    field_2,
    ...,
    field_n
]

где:
- field_n — поле группировки

Примеры:
- ["ACTIVE"]
- ["APP_CODE", "ACTIVE"]

Список доступных полей смотрите в разделе Тип элемента result

limit integer необязательный

Лимит записей

offset integer необязательный

Смещение записей

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

curl -X POST \
  -H "Content-Type: application/json" \
  -d '{
    "params": {
      "select": ["ID", "NAME", "DATE_MODIFY"],
      "filter": {"ACTIVE": "Y"},
      "order": {"ID": "DESC"},
      "group": ["ACTIVE"]
    }
  }' \
  "https://**put.your-domain-here**/rest/**user_id**/**webhook_code**/landing.repo.getList.json"

Ответ

HTTP-статус: 200

{
    "result": [
        {
            "ID": "5",
            "XML_ID": "ctx_full_1774873150158",
            "APP_CODE": "bitrix.restapi",
            "ACTIVE": "Y",
            "NAME": "Context full test block",
            "DESCRIPTION": "Check full fields from getList",
            "SECTIONS": "cover,about",
            "SITE_TEMPLATE_ID": null,
            "PREVIEW": "https://www.bitrix24.ru/images/b24_screen.png",
            "MANIFEST": {
                "block": {
                    "name": "Context full test block"
                },
                "nodes": {
                    ".landing-block-node-text": {
                        "name": "Text",
                        "type": "text"
                    }
                }
            },
            "CONTENT": "<section class=\"landing-block\"><div class=\"container\">Test</div></section>",
            "CREATED_BY_ID": "577",
            "MODIFIED_BY_ID": "577",
            "DATE_CREATE": "30.03.2026 14:19:11",
            "DATE_MODIFY": "30.03.2026 14:19:11"
        }
    ],
    "time": {
        "start": 1774873153,
        "finish": 1774873153.634216,
        "duration": 0.6342160701751709,
        "processing": 0,
        "date_start": "2026-03-30T15:19:13+03:00",
        "date_finish": "2026-03-30T15:19:13+03:00",
        "operating_reset_at": 1774873753,
        "operating": 0.11733078956604004
    }
}

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

result object[]

Список блоков подробнее

time time

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

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

HTTP-статус: 400

{
    "error": "ERROR_ARGUMENT",
    "error_description": "The value of an argument 'params' has an invalid type",
    "argument": "params"
}
Код Описание Значение
ACCESS_DENIED Недостаточно прав Пользователь не прошел общие проверки доступа
ERROR_ARGUMENT The value of an argument 'params' has an invalid type Передан аргумент params в неверном типе
SYSTEM_ERROR Внутренняя ошибка Ошибка при выполнении метода на стороне сервера
insufficient_scope Недостаточно scope у токена Токен не содержит scope landing

Что будем искать? Например,Продвижение

Этот сайт использует куки-файлы. Оставаясь на сайте, Вы соглашаетесь на их использование. Для получения дополнительной информации, пожалуйста, ознакомьтесь с политикой в отношении персональных данных.