Быстрый старт

Настроить Консоль управления можно как в веб-версии, так и через API.

Создать контейнер

Контейнеры позволяют применять набор политик к привязанным сотрудникам и вложенным контейнерам. Чтобы создать контейнер, выполните POST-запрос.

Пример запроса
POST https://corp.browser.yandex.ru/browser/public/api/browser-management/container

Authorization: <ваш API-токен>
Content-Type: application/JSON

{
    "name": "container"
}
Пример ответа
HTTP/1.1 200 OK

Content-Type: application/JSON

{
    "createdAt":"2025-05-07T10:21:54.570Z",
    "description":null,
    "id":"id",
    "name":"container",
    "partnerId":"partnerId",
    "profileId":null,
    "catalogConnectionId":null,
    "hasNestedContainers":false,
    "parentId":null
}

Добавить сотрудников

Чтобы добавить списком, используйте метод с файлом CSV. Заполните шаблон, проверьте его корректность и выполните POST-запрос. При этом сотрудники привязываются к профилю из пути к ресурсу {profileId}.

Пример запроса
POST https://corp.browser.yandex.ru/browser/public/api/browser-management/container/{containerId}/employee/csv ?

*overrideDuplicate=<true/false>

Authorization: <ваш API-токен>
Content-Type: multipart/form-data

{
    "employeesInfo": "binary"
}
Пример ответа
HTTP/1.1 200 OK

Content-Type: application/JSON

{
    "createdEmployees": [
        {
            "id": "1",
            "departmentId": "Бухгалтерия",
            "email": "example@ya.ru",
            "fullName": "Иван Иванов",
            "profileId": "1",
            "source": "CSV_FILE"
        }
    ],
    "departments": [
        {
            "id": "1",
            "name": "Бухгалтерия"
        }
    ]
}

Зарегистрировать устройства сотрудников

Отправьте письма с ссылкой, чтобы зарегистрировать Браузеры на устройствах сотрудников в Консоли управления.

Сначала нужно получить ID сотрудников с помощью GET-запроса.

Пример запроса
GET https://corp.browser.yandex.ru/browser/public/api/browser-management/employee-list ?

[employee_fullName_contains=<Иван Иванов>]
& [employee_fullName_contains=<Петр Петров>]
& [employee_fullName_mode=<insensitive>]

Authorization: <ваш API-токен>
Пример ответа
HTTP/1.1 200 OK

Content-Type: application/JSON

{
    "employees": [
        {
        "id": "1",
        "departmentId": "1",
        "email": "example-1@ya.ru",
        "fullName": "Иван Иванов",
        "profileId": "1",
        "source": "CSV_FILE"
        },
        {
        "id": "2",
        "departmentId": "1",
        "email": "example-2@ya.ru",
        "fullName": "Петр Петров",
        "profileId": "1",
        "source": "CSV_FILE"
        },
    ]
}

Теперь можно отправить письма с помощью POST-запроса.

Пример запроса
POST https://corp.browser.yandex.ru/browser/public/api/browser-management/employees/sendEmails

Authorization: <ваш API-токен>
Content-Type: application/JSON

{
  "employees": [
    {
      "email": "example-1@ya.ru",
      "employeeId": "1"
    },
    {
      "email": "example-2@ya.ru",
      "employeeId": "2"
    }
  ]
}
Пример ответа
HTTP/1.1 200 OK

Content-Type: application/JSON

Настроить политики

Чтобы задать политики в профиле, выполните PUT-запрос, указав в пути к ресурсу ID профиля и название политики. ID профиля можно получить из GET-запросов Контейнеров, Сотрудников или Девайсов.

Пример запроса
PUT https://corp.browser.yandex.ru/browser/public/api/browser-management/profile/policy/UseTabGroups

Authorization: <ваш API-токен>
Content-Type: application/JSON

{
    "comment": "Включить группы вкладок",
    "state": "ENABLED",
    "policyOption": "RECOMMENDED"
}
Пример ответа
HTTP/1.1 200 OK

Content-Type: application/JSON

{
    "id": "1",
    "name": "UseTabGroups",
    "comment": "Включить группы вкладок",
    "state": "ENABLED",
    "policyOption": "RECOMMENDED"
}
Предыдущая
Подключение и доступ
Следующая
Глоссарий