employer_departments.md

Справочник департаментов работодателя

Для того, чтобы узнать список департаментов работодателя, необходимо отправить запрос GET на /employers/{employer_id}/departments. Данный справочник доступен только для работодателей. В случае успешного выполнения запроса будет возвращён статус HTTP 200 OK, а в теле ответа будет возвращён список департаментов работодателя, например:

{
    "items": [
        {
            "id": "18320489-18320489-dept1", 
            "name": "DEPT#1"
        }, {
            "id": "18320489-18320489-dept2", 
            "name": "DEPT#2"
        }
    ]
}

В элементе items содержится список департаментов работодателя. Каждый элемент из items обладает следующими полями:

Имя	Тип	Описание
id	строка	Идентификатор департамента
name	строка	Название департамента

В случае, когда с текущей авторизацией запрещено просматривать департаменты данного работодателя, будет возвращён код HTTP 403 Forbidden.