workplaces.office.get
Scope:
workplacesКто может вызывать: Авторизованный пользователь с правом чтения (R) на раздел
Возвращает один раздел по id.
Объект раздела (город / офис / комната):
id,name,active,sort,depthLevel,parentIdcode,color,iconSize,departmentIds,sizeSvg,patternSvgfreeLimitGroupId,importSvgFileId,importSvgUrl,timeZone(id,xmlId,value)
HTTP: GET
Побочные эффекты: none
Параметры метода
| Параметр | Тип | Обяз. | Описание |
|---|---|---|---|
id |
int |
да | ID раздела |
Возвращаемые данные
Объект раздела в result.result.
Обработка ошибок
Ответ в едином конверте модуля: result, total, next, error (внутри обёртки Bitrix REST — поле result). Справочник всех кодов: error-codes.md.
| Код | Описание |
|---|---|
UNAUTHORIZED |
Пользователь не авторизован |
INTERNAL_ERROR |
Внутренняя ошибка |
VALIDATION_ERROR |
Параметр id не передан или ≤ 0; details.field = id |
NOT_FOUND |
Раздел не найден или неверный уровень (город/офис/комната) |
ACCESS_DENIED |
Нет права чтения (R) на раздел |
Примеры кода
Пример запроса (GET)
curl -G "https://{портал}/rest/{user_id}/{webhook_code}/workplaces.office.get.json?id=101" \
-H "Accept: application/json"
Пример ответа
{
"result": {
"result": {
"id": 108,
"name": "Офис K1",
"active": true,
"sort": 500,
"depthLevel": 2,
"parentId": 101,
"code": "office_sample"
},
"next": null,
"error": null
},
"total": 0
}
Предыдущая
Следующая