workplaces.office.get

Scope: workplaces

Кто может вызывать: Авторизованный пользователь с правом чтения (R) на раздел

Возвращает один раздел по id.

Объект раздела (город / офис / комната):

  • id, name, active, sort, depthLevel, parentId
  • code, color, iconSize, departmentIds, sizeSvg, patternSvg
  • freeLimitGroupId, 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
        }
        
Предыдущая
Следующая