crm.contact.details.configuration.get
Получить параметры карточки
Описание
Метод получает настройки карточки контактов: читает личные настройки карточки указанного пользователя или общие настройки, заданные для всех пользователей.
Параметры
scope
string
необязательный
Область применения настроек.
Возможные значения:
- P — личные настройки
- C — общие настройки
По умолчанию — P
userId
user
необязательный
Идентификатор пользователя. Нужен только при запросе чужих личных настроек.
Если не задан, то берется текущий
Примеры запроса
curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"scope":"P","userId":6}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/crm.contact.details.configuration.get
curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"scope":"P","userId":6,"auth":"**put_access_token_here**"}' \
https://**put_your_bitrix24_address**/rest/crm.contact.details.configuration.get
BX24.callMethod(
'crm.contact.details.configuration.get',
{
scope: "P",
userId: 6,
},
(result) => {
result.error()
? console.error(result.error())
: console.info(result.data())
;
},
);
require_once('crest.php');
$result = CRest::call(
'crm.contact.details.configuration.get',
[
'scope' => 'P',
'userId' => 6
]
);
echo '<PRE>';
print_r($result);
echo '</PRE>';
// client и ctx уже созданы — см. раздел «SDK для Go»
res, err := client.Core().Call(ctx, "crm.contact.details.configuration.get", b24.Params{
"scope": "P",
"userId": 6,
}, b24.WithIdempotent())
if err != nil {
return fmt.Errorf("crm.contact.details.configuration.get: %w", err)
}
var items []struct {
Name string `json:"name"`
Title string `json:"title"`
Type string `json:"type"`
}
if err := json.Unmarshal(res.Result, &items); err != nil {
return fmt.Errorf("разбор ответа: %w", err)
}
for _, it := range items {
fmt.Println(it.Name, it.Title)
}
Ответ
HTTP-статус: 200
{
"result": [
{
"name": "main",
"title": "О контакте",
"type": "section",
"elements": [
{
"name": "LAST_NAME",
"optionFlags": "0"
},
{
"name": "PHOTO",
"optionFlags": "0"
},
{
"name": "NAME",
"optionFlags": "1"
},
{
"name": "SECOND_NAME",
"optionFlags": "1"
},
{
"name": "BIRTHDATE",
"optionFlags": "1"
},
{
"name": "PHONE",
"optionFlags": "1",
"options": {
"defaultCountry": "AU"
}
},
{
"name": "EMAIL",
"optionFlags": "1"
}
]
},
{
"name": "additional",
"title": "Дополнительно",
"type": "section",
"elements": [
{
"name": "TYPE_ID",
"optionFlags": "0"
},
{
"name": "SOURCE_ID",
"optionFlags": "0"
},
{
"name": "OPENED",
"optionFlags": "0"
},
{
"name": "EXPORT",
"optionFlags": "0"
},
{
"name": "ASSIGNED_BY_ID",
"optionFlags": "0"
}
]
}
],
"time": {
"start": 1724677217.639681,
"finish": 1724677217.986853,
"duration": 0.3471717834472656,
"processing": 0.01840806007385254,
"date_start": "2024-08-26T15:00:17+02:00",
"date_finish": "2024-08-26T15:00:17+02:00",
"operating": 0
}
}
Возвращаемые данные
result
section[]
Корневой элемент ответа.
Содержит конфигурацию разделов детальной карточки элемента.
Возвращает null в случае отсутствия конфигурации
time
time
Информация о времени выполнения запроса
Обработка ошибок
HTTP-статус: 400
{
"error": "",
"error_description": "Access denied."
}
| Код | Описание | Значение |
|---|---|---|
| — | Access denied. | У пользователя нет административных прав |

