Получить список всех устройств в сервисе

Deprecated

Отдает список всех устройств в сервисе

Request

GET

https://corp.browser.yandex.ru/browser/public/api/browser-management/devices

Query parameters

Name	Description
department_id	Type: string Фильтрация по id департамента
department_id_in	Type: string Фильтрация по белому списку id департаментов. Идентификаторы должны быть указаны через запятую
department_id_not	Type: string Фильтрация, исключающая из выборки департамент id
department_id_not_in	Type: string Фильтрация по черному списку id департаментов. Идентификаторы должны быть указаны через запятую
department_name	Type: string Фильтрация по названию департамента
department_name_in	Type: string Фильтрация по белому списку названию департамента. Параметры должны быть указаны через запятую
department_name_not	Type: string Фильтрация, исключающая из выборки департамент по имени
department_name_not_in	Type: string Фильтрация по черному списку названию департамента Параметры должны быть указаны через запятую
device_id	Type: string Фильтрация по id девайса
device_id_in	Type: string Фильтрация по белому списку id девайсов. Идентификаторы должны быть указаны через запятую
device_id_not	Type: string Фильтрация, исключающая из выборки девайс id
device_id_not_in	Type: string Фильтрация по черному списку id девайсов. Идентификаторы должны быть указаны через запятую
device_os_platform	Type: string Фильтрация по платформе
device_os_platform_in	Type: string Фильтрация по белому списку id платформ. Параметры должны быть указаны через запятую
device_os_platform_not	Type: string Фильтрация по платформе
device_os_platform_not_in	Type: string Фильтрация по черному списку id платформ. Параметры должны быть указаны через запятую
employee_id	Type: string Фильтрация по id сотрудника
employee_id_in	Type: string Фильтрация по белому списку id сотрудников. Идентификаторы должны быть указаны через запятую
employee_id_not	Type: string Фильтрация, исключающая из выборки сотрудника по id
employee_id_not_in	Type: string Фильтрация по черному списку id сотрудников. Идентификаторы должны быть указаны через запятую
profile_id	Type: string Фильтрация по id профиля
profile_id_in	Type: string Фильтрация по белому списку id профилей. Идентификаторы должны быть указаны через запятую
profile_id_not	Type: string Фильтрация, исключающая из выборки профиль по id
profile_id_not_in	Type: string Фильтрация по черному списку id профилей. Идентификаторы должны быть указаны через запятую
profile_name	Type: string Фильтрация по названию профиля
profile_name_in	Type: string Фильтрация по белому списку названию профиля. Параметры должны быть указаны через запятую
profile_name_not	Type: string Фильтрация, исключающая из выборки профиль по имени
profile_name_not_in	Type: string Фильтрация по черному списку названию профиля. Параметры должны быть указаны через запятую
skip	Type: string Количество записей, которое будет пропущено перед формированием ответа
sort_order	Type: string Порядок сортировки (asc - по возрастанию, desc - по убыванию), по умолчанию asc Default: `asc` Enum: `asc`, `desc`
take	Type: string Целое положительное число, обозначающее количество объектов в ответе. Максимум 1000. По умолчанию 1000

Responses

200 OK

Body

application/json

{
    "departments": {
        "id": "string",
        "name": "string",
        "partnerId": "string"
    },
    "devices": [
        {
            "id": "string",
            "physicalDeviceId": "string",
            "brandName": "string",
            "computerName": "string",
            "deviceModel": "string",
            "machineName": "string",
            "osVersion": "string",
            "osPlatform": "string",
            "serialNumber": "string",
            "browserVersion": "string",
            "shouldRestart": false,
            "matchingState": "ENABLED or DISABLED",
            "employeeId": "string",
            "containerId": "string",
            "profileId": "string",
            "personalProfileId": "string",
            "licenceId": "string",
            "createdAt": "string",
            "updatedAt": "string",
            "userLogin": "string"
        }
    ],
    "employees": {
        "id": "string",
        "departmentId": "string",
        "email": "string",
        "fullName": "string",
        "userLogin": "string",
        "profileId": "string",
        "source": "CSV_FILE"
    },
    "profiles": {
        "id": "string",
        "name": "string",
        "description": "string",
        "createdAt": "string",
        "partnerId": "string"
    }
}

Name	Description
departments*	Type: Department Объект, показывающий соответствие id и отдела
devices*	Type: ExtendedDevice[] Список устройств Расширенный объект устройства с профилем и сотрудником
employees*	Type: Employee Объект, показывающий соответствие id и сотрудника
profiles*	Type: Profile Объект, показывающий соответствие id и профиля

Department

Объект, показывающий соответствие id и отдела

Name	Description
id*	Type: string Уникальный идентификатор отдела
name*	Type: string Имя отдела
partnerId*	Type: string Уникальный идентификатор партнера

ExtendedDevice

Расширенный объект устройства с профилем и сотрудником

Name	Description
brandName*	Type: string Название бренда утсройства
browserVersion*	Type: string Версия браузера на устройстве
computerName*	Type: string Имя устройства
containerId*	Type: string Уникальный идентификатор контейнера
createdAt*	Type: string Timestamp даты создания устройства
deviceModel*	Type: string Модель устройства
employeeId*	Type: string Уникальный идентификатор сотрудника
id*	Type: string Уникальный идентификатор устройства
licenceId*	Type: string Уникальный идентификатор лицензии
machineName*	Type: string Имя машины
matchingState*	Type: MatchingState Статус участия девайса в процессе мэтчинга Example: `ENABLED or DISABLED` Enum: `ENABLED`, `DISABLED`
osPlatform*	Type: string Платформа устройства
osVersion*	Type: string Версия операционной системы
physicalDeviceId*	Type: string Уникальный идентификатор реального устройства
profileId*	Type: string Уникальный идентификатор профиля
serialNumber*	Type: string Серийный номер устройства
shouldRestart*	Type: boolean Нужно ли перезагрузить девайс
updatedAt*	Type: string Timestamp даты обновления устройства
personalProfileId	Type: string Уникальный идентификатор профиля
userLogin	Type: string Логин устройства

Employee

Объект, показывающий соответствие id и сотрудника

Name	Description
departmentId*	Type: string Уникальный идентификатор отдела
email*	Type: string Почта сотрудника
fullName*	Type: string Имя сотрудника
id*	Type: string Уникальный идентификатор сотрудника
profileId*	Type: string Уникальный идентификатор профиля
source*	Type: string Источник создания записи о сотруднике Enum: `CSV_FILE`, `MANUAL`, `API`
userLogin*	Type: string логин устройства сотрудника

Profile

Объект, показывающий соответствие id и профиля

Name	Description
createdAt*	Type: string Timestamp даты создания профиля
id*	Type: string Уникальный идентификатор профиля
name*	Type: string Имя профиля
partnerId*	Type: string Уникальный идентификатор партнера
description	Type: string Описание профиля

MatchingState

Статус участия девайса в процессе мэтчинга

Type

Description

MatchingState

Example: ENABLED or DISABLED

Enum: ENABLED, DISABLED

400 Bad Request

к устройству не привязан профиль (NO_PROFILE_IS_BOUND_TO_DEVICE)

Была ли статья полезна?

Замэтчить устройства партнера в соответствии с настройками

Получить профиль девайса партнера или создать, если его еще нет