метод REST scope: department

department.get

Получить список подразделений

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

Описание

Метод department.get предназначен для получения списка подразделений.

Параметры

sort string необязательный

Название поля, по которому нужна сортировка. Сортировка работает по полям:
- ID — идентификатор подразделения
- NAME — название подразделения
- SORT — порядок сортировки
- PARENT — идентификатор родительского отдела
- UF_HEAD — идентификатор пользователя-руководителя отдела

order string необязательный

Направление сортировки:
- ASC — по возрастанию
- DESC — по убыванию

ID integer необязательный

Фильтр по идентификатору подразделения

NAME string необязательный

Фильтр по имени подразделения. Указывается полное название подразделения

SORT integer необязательный

Фильтр по полю сортировки

PARENT integer необязательный

Фильтр по идентификатору родительского подразделения

UF_HEAD integer необязательный

Фильтр по идентификатору руководителя подразделения

START integer необязательный

Параметр используется для управления постраничной навигацией.

Размер страницы результатов всегда статичный: 50 записей.

Чтобы выбрать вторую страницу результатов, необходимо передавать значение 50. Чтобы выбрать третью страницу результатов — значение 100 и так далее.

Формула расчета значения параметра start:

start = (N-1) * 50, где N — номер нужной страницы.

Подробности в статье List methods pecularities

Примеры запроса

-X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{
    "sort": "NAME",
    "order": "DESC",
    "PARENT": 1
}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/department.get

Ответ

HTTP-статус: 200

{
  "result": [
    {
      "ID": "15",
      "NAME": "R\u0026D",
      "SORT": 500,
      "PARENT": "1"
    },
    {
      "ID": "2",
      "NAME": "Бухгалтерия",
      "SORT": 500,
      "PARENT": "1"
    },
    {
      "ID": "4",
      "NAME": "Отдел маркетинга и рекламы",
      "SORT": 500,
      "PARENT": "1"
    },
    {
      "ID": "3",
      "NAME": "Отдел продаж",
      "SORT": 500,
      "PARENT": "1"
    },
    {
      "ID": "17",
      "NAME": "Юр. отдел",
      "SORT": 500,
      "PARENT": "1"
    }
  ],
  "total": 5,
  "time": {
    "start": 1736924749.531017,
    "finish": 1736924749.719845,
    "duration": 0.1888279914855957,
    "processing": 0.00179290771484375,
    "date_start": "2025-01-15T07:05:49+00:00",
    "date_finish": "2025-01-15T07:05:49+00:00",
    "operating": 0
  }
}

Возвращаемые данные

result department[]

Корневой элемент ответа, который содержит отфильтрованный список подразделений

total integer

Общее количество найденных записей

time time

Информация о времени выполнения запроса

Что будем искать? Например,Продвижение

Этот сайт использует куки-файлы. Оставаясь на сайте, Вы соглашаетесь на их использование. Для получения дополнительной информации, пожалуйста, ознакомьтесь с политикой в отношении персональных данных.