# changeportaldefaultheme.mode.list
Scope:
changeportaldefaulthemeКто может вызывать: Любой авторизованный пользователь. Подробнее: Права доступа
Справочник значений режима управления модулем (module_mode)
HTTP: GET
Побочные эффекты: none
Параметр filter не поддерживается — только пагинация. Значение value используйте в theme.update / theme.reset для параметра module_mode.
Параметры метода
| Параметр | Тип | Обяз. | Описание |
|---|---|---|---|
limit |
int |
нет | Размер страницы, по умолчанию 50, максимум 500 |
offset |
int |
нет | Смещение, по умолчанию 0 |
fetchAll |
bool |
нет | Вернуть все записи одним ответом |
Пагинация
limit (по умолчанию 50, максимум 500), offset, fetchAll (защитный лимит 5000, иначе FETCH_ALL_LIMIT_EXCEEDED).
Возвращаемые данные
Ответ в конверте модуля: result.result — массив {value, label}:
value |
label |
|---|---|
N |
Модуль включён |
Y |
Модуль выключен |
result.error; поле next в конверте ответа не возвращается, если следующей страницы нет. Общее число записей — в верхнеуровневом Bitrix total.
Обработка ошибок
| Код | Описание |
|---|---|
UNAUTHORIZED |
Пользователь не авторизован |
INVALID_LIMIT |
limit < 1 |
LIMIT_TOO_HIGH |
limit > 500 |
INVALID_OFFSET |
offset < 0 |
FETCH_ALL_LIMIT_EXCEEDED |
При fetchAll=true записей больше защитного лимита |
INTERNAL_ERROR |
Внутренняя ошибка сервера |
Пример запроса (GET)
Прогон на портале 76593.dev.wehive.digital, пользователь вебхука 1.
curl -G "https://{портал}/rest/{user_id}/{webhook_code}/changeportaldefaultheme.mode.list.json" \
-H "Accept: application/json" \
--data-urlencode "limit=50" \
--data-urlencode "offset=0"
Пример ответа
{
"result": {
"result": [
{
"value": "N",
"label": "Модуль включён"
},
{
"value": "Y",
"label": "Модуль выключен"
}
],
"error": null
},
"total": 2
}
Пример ответа (ошибка)
limit=0:
{
"result": {
"result": null,
"error": {
"code": "INVALID_LIMIT",
"message": "Параметр limit должен быть больше 0.",
"details": null
}
}
}