diff --git a/docs/employer_vacancies.md b/docs/employer_vacancies.md index 91947d01..f2cd2d04 100644 --- a/docs/employer_vacancies.md +++ b/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). + ### Полезные ссылки @@ -575,6 +578,8 @@ Cоставные поля (например, `salary`, `contacts`, `specializat валюты в зарплате, необходимо передавать также и значения зарплаты, а для изменения специализации необходимо передать полный список. +>!! Внимание! При редактировании вакансии будет указан [выбранный отдел](manager_divisions.md#using-division). + ### Поля доступные для редактирования Имя | Описание diff --git a/docs/errors.md b/docs/errors.md index 254000f1..f333f892 100644 --- a/docs/errors.md +++ b/docs/errors.md @@ -524,3 +524,9 @@ HTTP code | type | value | описание ``` где `allowed_accounts` содержит массив доступных для этого токена аккаунтов Элементы массива аналогичны [результату, выдаваемому в списке рабочих аккаунтов](manager_accounts.md#account-info) + + +### Отделы менеджера +HTTP code | type | value | описание +----------|------|-------|----------- +400 | manager_divisions | manager_not_in_division | Менеджер не состоит в отделе. Попросите администратора добавить вас в отдел или [посмотрите доступные отделы](manager_divisions.md#get-manager-divisions) diff --git a/docs/manager_divisions.md b/docs/manager_divisions.md new file mode 100644 index 00000000..2983690a --- /dev/null +++ b/docs/manager_divisions.md @@ -0,0 +1,85 @@ +# Отделы менеджера + +Менеджер может выполнять действия от лица нескольких отделов. Для взаимодействия с API в контексте определенного +отдела работодателя нужно использовать соответсвующий отдел. +У пользователя может быть несколько отделов, один из них является текущим. Какой отдел является текущим можно узнать, +получив [список отделов менеджера](#get-manager-divisions). Текущий отдела используется, если в качестве авторизации посылать только токен +(подробнее можно прочитать [здесь](#using-division)). + +* [Получение списка отделов пользователя](#get-manager-divisions) +* [Выбор отдела при запросах](#using-division) + + +## Получение списка отделов пользователя + +### Запрос + +``` +GET /manager_divisions/mine +``` + +### Ответ + +Успешный ответ приходит с кодом `200 OK` и содержит тело: + +```json +{ + "found": 2, + "page": 0, + "pages": 1, + "per_page": 2, + "items": [ + { + "id": "1", + "name": "Департамент персонала" + }, + { + "id": "2", + "name": "Департамент продаж" + } + ], + "current_division_id": "2" +} +``` + +где: + +Имя | Тип | Описание +--- | --- | ------ +items | список | список отделов менеджера +current_division_id | строка | идентификатор текущего отдела (совпадает со значением переданного в заголовке) + + +#### Объект `division` + +Имя | Тип | Описание +--- | --- | ------ +id | строка | идентификатор отдела +name | строка | название отдела компании + +### Ошибки + +* `403 Forbidden` — ошибка авторизации (пользователь не является менеджером) +* `404 Not Found` — нет отделов у менеджера + + + +## Выбор отдела при запросах + +Для работы под определенным отделом необходимо передать значение `division_id`, полученное из [списка](#get-manager-divisions), в заголовке: + +``` +X-Manager-Division-Id: {division_id} +``` + +Использовать данный заголовок можно во всех методах, доступных для работодателей. + +В заголовке можно передавать `division_id` текущего отдела, который также подразумевается по умолчанию, при отсутсвии заголовка. + + + +## Ошибки + +* `403 Forbidden` — ошибка авторизации (при запросах с авторизацией не работодателя) +* `404 Not Found` — отдел с переданным `division_id` не найден +* [Дополнительные ошибки с описанием причины](/docs/errors.md#manager-divisions). diff --git a/docs/resumes.md b/docs/resumes.md index de68bc1d..2c81cf4c 100644 --- a/docs/resumes.md +++ b/docs/resumes.md @@ -234,6 +234,8 @@ paid_services | object | [платные услуги по резюме для >!! Внимание произошли изменения в доступе к контактной информации. Прочитайте внимательно информацию про [поконтактный доступ к резюме](payable/resume.md#contact-data) +>!! Внимание! Если в вашей компании используются отделы, то контакт будет списан у [выбранного отдела](manager_divisions.md#using-division). + Для авторизованного автора возвращается [более детальная информация](#additional-author-fields), включая тип видимости, комментарии модераторов и статус. diff --git a/docs/vacancies.md b/docs/vacancies.md index 5eb69c86..516cd439 100644 --- a/docs/vacancies.md +++ b/docs/vacancies.md @@ -386,7 +386,10 @@ suitable_resumes_url | string | Подходящие резюме на вака "id": "marketing", "name": "Маркетинг" }, - "can_upgrade_billing_type": true + "can_upgrade_billing_type": true, + "division": { + "id": "123" + } } ``` @@ -399,6 +402,8 @@ can_upgrade_billing_type | логический | Можно ли улучшит В объекте `manager` — информация о менеджере, который разместил данную вакансию. +В объекте `division` — информация об отделе, от которого размещена данная вакансия. + В объекте `branded_template` — информация об используемом в вакансии [брендированном шаблоне](employer_vacancy_branded_templates.md).