HH-123770 отделы работодателей

docs/employer_vacancies.md

@@ -23,6 +23,7 @@
 ## Возможные варианты публикации вакансий у текущего менеджера
 
 Метод нужен, чтобы понять, может ли менеджер публиковать вакансии и какие типы вакансий ему доступны. Возвращает все возможные типы публикации.
+> Внимание! Если в вашей компании используются отделы, то будут возвращены возможные варианты публикации [текущего отдела](manager_divisions.md#using-division).
 
 ### Запрос
 
@@ -140,6 +141,8 @@ publications[].areas_url | string | URL на список регионов, в 
 * все вакансии проходят ручную модерацию.
 * в течение нескольких минут после публикации вакансия станет доступна в поиске.
 
+>!! Внимание! Если в вашей компании используются отделы, то вакансия будет опубликована от лица [текущего отдела](manager_divisions.md#using-division).
+
 
 ### Полезные ссылки
 

docs/manager_divisions.md

@@ -0,0 +1,79 @@
+# Отделы менеджера
+
+Менеджер может выполнять действия от лица нескольких отделов. Для взаимодействия с API в контексте определенного
+отдела работодателя нужно использовать соответсвующий отдел.
+У пользователя может быть несколько отделов, один из них является текущим. Какой отдел является текущим можно узнать,
+получив [список отделов менеджера](#get-manager-divisions). Текущий отдела используется, если в качестве авторизации посылать только токен
+(подробнее можно прочитать [здесь](#using-division)).
+
+* [Получение списка отделов пользователя](#get-manager-divisions)
+* [Выбор отдела при запросах](#using-division)
+
+<a name="get-manager-divisions"></a>
+## Получение списка отделов пользователя
+
+### Запрос
+
+```
+GET /manager_divisions/mine
+```
+
+### Ответ
+
+Успешный ответ приходит с кодом `200 OK` и содержит тело:
+
+```json
+{
+    "items": [
+        {
+            "id": "1",
+            "name": "Департамент персонала"
+        },
+        {
+            "id": "2",
+            "name": "Департамент продаж"
+        }
+    ],
+    "current_division_id": "2"
+}
+```
+
+где:
+
+Имя | Тип | Описание
+--- | --- | ------
+items | список | список отделов менеджера
+current_division_id | строка | идентификатор текущего отдела (совпадает со значением переданного в заголовке)
+
+<a name="division-info"></a>
+#### Объект `division`
+
+Имя | Тип | Описание
+--- | --- | ------
+id | строка | идентификатор отдела
+name | строка | название отдела компании
+
+### Ошибки
+
+* `403 Forbidden` — ошибка авторизации (пользователь не является менеджером)
+
+
+<a name="using-division"></a>
+## Выбор отдела при запросах
+
+Для работы под определенным отделом необходимо передать значение `division_id`, полученное из [списка](#get-manager-divisions), в заголовке:
+
+```
+X-Manager-Division-Id: {division_id}
+```
+
+Использовать данный заголовок можно во всех методах, доступных для работодателей.
+
+В заголовке можно передавать `division_id` текущего отдела, который также подразумевается по умолчанию, при отсутсвии заголовка.
+
+
+<a name="errors"></a>
+## Ошибки
+
+* `403 Forbidden` — отдел с переданным `division_id` не найден. Дополнительно к коду вернется причина ошибки
+* `403 Forbidden` — ошибка авторизации (при запросах с авторизацией не работодателя)

docs/resumes.md

@@ -234,6 +234,8 @@ paid_services | object | [платные услуги по резюме для 
 
 >!! Внимание произошли изменения в доступе к контактной информации. Прочитайте внимательно информацию про [поконтактный доступ к резюме](payable/resume.md#contact-data)
 
+>!! Внимание! Если в вашей компании используются отделы, то контакт будет списан у [текущего отдела](manager_divisions.md#using-division).
+
 Для авторизованного автора возвращается
 [более детальная информация](#additional-author-fields), включая тип
 видимости, комментарии модераторов и статус.