метод REST scope: sale

sale.propertygroup.list

Получить список групп свойств

Кто может выполнять: администратор

Описание

Метод sale.propertygroup.list получает список групп свойств.

Параметры

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

Массив со списком полей, которые необходимо выбрать (смотрите поля объекта sale_order_property_group).

Если массив не передан или же передан пустой массив, то будут выбраны все доступные поля групп свойств

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

Объект для фильтрации выбранных групп свойств в формате {"field_1": "value_1", ... "field_N": "value_N"}.

Возможные значения для field соответствуют полям объекта sale_order_property_group.

Ключу можно задать дополнительный префикс, уточняющий поведение фильтра. Возможные значения префикса:
- + — фильтрация по точному значению заданного поля; при этом в выборку также попадают и те элементы, у которых значение поля не определено (NULL)
- >= — больше либо равно
- > — больше
- <= — меньше либо равно
- < — меньше
- % — LIKE, поиск по подстроке. Символ % в значении фильтра передавать не нужно. Поиск ищет подстроку в любой позиции строки
- != — не равно
- ! — не равно

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

Объект для сортировки выбранных групп свойств в формате {"field_1": "order_1", ... "field_N": "order_N"}.

Возможные значения для field соответствуют полям объекта sale_order_property_group.

Возможные значения для order:
- asc — в порядке возрастания
- desc — в порядке убывания

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

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"select":["id","name","personTypeId","sort"],"filter":{">=id":14},"order":{"name":"asc","id":"desc"}}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/sale.propertygroup.list

Ответ

HTTP-статус: 200

{
    "result":{
        "propertyGroups":[
            {
                "id":18,
                "name":"Новая группа свойств 2",
                "personTypeId":3,
                "sort":100
            },
            {
                "id":14,
                "name":"Новая группа свойств 1",
                "personTypeId":3,
                "sort":100
            }
        ]
    },
    "total":2,
    "time":{
        "start":1711544498.747502,
        "finish":1711544498.987554,
        "duration":0.2400519847869873,
        "processing":0.010115861892700195,
        "date_start":"2024-03-27T16:01:38+03:00",
        "date_finish":"2024-03-27T16:01:38+03:00"
    }
}

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

result object

Корневой элемент ответа

propertyGroups sale_order_property_group[]

Массив объектов с информацией о выбранных группах свойств

time time

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

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

HTTP-статус: 400

{
    "error":0,
    "error_description":"error"
}
Код Описание Значение
200040300010 Недостаточно прав для чтения групп свойств
0 Другие ошибки (например, фатальные ошибки)

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

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