Каждый PHP-разработчик, работающий с экосистемой Bitrix Framework, должен глубоко понимать работу её ключевых компонентов. В этой статье мы проведем подробный аудит темы «Получить список групп соцсети sonet_group.get», проанализируем лучшие практики и покажем, как правильно использовать получить список в реальных задачах.

Получить список групп соцсети sonet_group.get

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

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

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

Метод возвращает массив групп соцсети, каждая из которых содержит массив полей, осуществляя вызов CSocNetGroup::GetList(). При этом возвращаются только те группы, которые доступны пользователю по правам.

Запрос:

https://mydomain.bitrix24.ru/rest/sonet_group.get.json?auth=bbc392f317df617d02c942a78ad43aab&ORDER[NAME]=ASC&FILTER[%25NAME]=Прод

Ответ:

>200 OK

{
"result": [
    {
    "ID": "3",
    "SITE_ID": "s1",
    "NAME": "Продажи",
    "DESCRIPTION": "Маркетинговая группа по продажам",
    "DATE_CREATE": "2013-11-06T07:45:12+04:00",
    "DATE_UPDATE": "2013-11-06T07:45:12+04:00",
    "ACTIVE": "Y",
    "VISIBLE": "Y",
    "OPENED": "N",
    "CLOSED": "N",
    "SUBJECT_ID": "1",
    "OWNER_ID": "1",
    "KEYWORDS": "продажа, товар, маркетинг, рынок",
    "NUMBER_OF_MEMBERS": "1",
    "DATE_ACTIVITY": "2013-11-06T07:45:12+04:00",
    "SUBJECT_NAME": "Рабочие группы",
    "IMAGE": "https://cdn.bitrix24.ru/b211545/socialnetwork/ba9/ba9533b38f60ade077b64f06a60d7082/2.jpg",
    "IS_EXTRANET": "Y"
    }
],
"total": 1
}

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

Возвращает те же поля, что и CSocNetGroup::GetList(), за исключением INITIATE_PERMS, SPAM_PERMS и IMAGE_ID (вместо последнего возвращается поле IMAGE, с полями файла, соответствующего IMAGE_ID).

Практический пример и готовый код на PHP

• JS

    try
    {
    	const response = await $b24.callMethod('sonet_group.get', {
    		'ORDER': {
    			'NAME': 'ASC'
    		},
    		'FILTER': {
    			'%NAME': 'Прод'
    		}
    	});
    	
    	const result = response.getData().result;
    	console.log(result);
    }
    catch( error )
    {
    	console.error('Error:', error);
    }

• PHP

    try {
        $response = $b24Service
            ->core
            ->call(
                'sonet_group.get',
                [
                    'ORDER' => [
                        'NAME' => 'ASC'
                    ],
                    'FILTER' => [
                        '%NAME' => 'Прод'
                    ]
                ]
            );
    
        $result = $response
            ->getResponseData()
            ->getResult();
    
        echo 'Success: ' . print_r($result, true);
        // Нужная вам логика обработки данных
        processData($result);
    
    } catch (Throwable $e) {
        error_log($e->getMessage());
        echo 'Error getting social network groups: ' . $e->getMessage();
    }

• BX24.js

    // Получим список всех доступных групп соцсети, название которых начинается с подстроки "Прод", отсортированный по названию в алфавитном порядке
    BX24.callMethod('sonet_group.get', {
        'ORDER': {
            'NAME': 'ASC'
        },
        'FILTER': {
            '%NAME': 'Прод'
        }
    });