From e89a20c6d8a53fd9345922246353db0a324ece62 Mon Sep 17 00:00:00 2001 From: vorobev Date: Mon, 8 Feb 2021 12:50:21 +0300 Subject: [PATCH 1/7] =?UTF-8?q?HH-123770=20=D1=87=D0=B5=D1=80=D0=BD=D0=BE?= =?UTF-8?q?=D0=B2=D0=B8=D0=BA=20=D0=B0=D0=BF=D0=B8=20=D0=BF=D0=BE=20=D0=BE?= =?UTF-8?q?=D1=82=D0=B4=D0=B5=D0=BB=D0=B0=D0=BC?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/employer_divisions.md | 63 ++++++++++++++++++++++++++++++++++++++ docs/employer_vacancies.md | 6 +++- docs/resumes.md | 9 ++++-- 3 files changed, 74 insertions(+), 4 deletions(-) create mode 100644 docs/employer_divisions.md diff --git a/docs/employer_divisions.md b/docs/employer_divisions.md new file mode 100644 index 00000000..1c04f0b3 --- /dev/null +++ b/docs/employer_divisions.md @@ -0,0 +1,63 @@ +# Отделы работодателя + +* [Получение информации об отделах менеджера](#item) +* [Получение информации об отделе](#item) + +Для получения информации необходимо авторизоваться под работодателем. +Для пользователя без авторизации или для неправильно авторизованного пользователя вернется ответ `403 Forbidden`. + + + +## Получение информации об отделе + +### Запрос + +`GET /employers/{employer_id}/managers/{manager_id}/divisions` + +где: + +* `employer_id` - идентификатор работодателя, который можно узнать в + [информации о текущем пользователе](me.md#employer-info). +* `manager_id` - идентификатор менеджера. + +### Ответ + +В случае успешного выполнения запроса, будет возвращён статус `200 OK`. +В теле ответа будет содержаться информация об отделах менеджера, например: + +```json +{ + тут список отделов менеджера +} +``` + +### Ошибки +* `404 Not Found` - Работодатель или менеджер не найдены, или у пользователя нет прав + + + +## Получение информации об отделе + +### Запрос + +`GET /employers/{employer_id}/divisions/{division_id}` + +где: + +* `employer_id` - идентификатор работодателя, который можно узнать в + [информации о текущем пользователе](me.md#employer-info). +* `manager_id` - идентификатор менеджера. + +### Ответ + +В случае успешного выполнения запроса, будет возвращён статус `200 OK`. +В теле ответа будет содержаться информация об отделе, например: + +```json +{ + тут информация об отделе менеджера +} +``` + +### Ошибки +* `404 Not Found` - Работодатель или менеджер не найдены, или у пользователя нет прав diff --git a/docs/employer_vacancies.md b/docs/employer_vacancies.md index 91947d01..aee3add2 100644 --- a/docs/employer_vacancies.md +++ b/docs/employer_vacancies.md @@ -26,13 +26,14 @@ ### Запрос -```GET /employers/{employer_id}/managers/{manager_id}/vacancies/available_types``` +```GET /employers/{employer_id}/managers/{manager_id}/vacancies/available_types?divisionId={division_id}``` где: * `employer_id` - идентификатор работодателя, который можно узнать в [информации о текущем пользователе](me.md#employer-info). * `manager_id` - идентификатор менеджера. Можно узнать в [информации о текущем пользователе](me.md#manager-info). +* `division_id` - идентификатор отдела. ### Ответ @@ -222,6 +223,9 @@ publications[].areas_url | string | URL на список регионов, в "manager": { "id": "321" }, + "division": { + "id": "111" + }, "test": { "id": "42", "required": true diff --git a/docs/resumes.md b/docs/resumes.md index de68bc1d..489ea072 100644 --- a/docs/resumes.md +++ b/docs/resumes.md @@ -1047,14 +1047,17 @@ expires | строка (дата) | время окончания действи }, "download_with_contact": { "pdf": { - "url": "https://hh.ru/api_resume_converter/12345678901234567890123456789012abcdef/ФамилияИмяОтчество.pdf?type=pdf&with_contact=2703892fa808bc3" + "url": "https://hh.ru/api_resume_converter/12345678901234567890123456789012abcdef/ФамилияИмяОтчество.pdf?type=pdf&with_contact=2703892fa808bc3", + "division_id": 123 }, "rtf": { - "url": "https://hh.ru/api_resume_converter/12345678901234567890123456789012abcdef/ФамилияИмяОтчество.rtf?type=rtf&with_contact=2703892fa808bc3" + "url": "https://hh.ru/api_resume_converter/12345678901234567890123456789012abcdef/ФамилияИмяОтчество.rtf?type=rtf&with_contact=2703892fa808bc3", + "division_id": 123 } }, "get_with_contact": { - "url": "https://api.hh.ru/resumes/12345678901234567890123456789012abcdef?with_contact=2703892fa808bc3" + "url": "https://api.hh.ru/resumes/12345678901234567890123456789012abcdef?with_contact=2703892fa808bc3", + "division_id": 123 } }, "paid_services": [ From 5780ba72956b00b0d73a7a67733ffd80023ab9d4 Mon Sep 17 00:00:00 2001 From: vorobev Date: Tue, 9 Feb 2021 11:35:54 +0300 Subject: [PATCH 2/7] =?UTF-8?q?HH-123770=202-=D1=8F=20=D0=B8=D1=82=D0=B5?= =?UTF-8?q?=D1=80=D0=B0=D1=86=D0=B8=D1=8F=20=D0=BF=D0=BE=20=D0=BE=D1=82?= =?UTF-8?q?=D0=B4=D0=B5=D0=BB=D0=B0=D0=BC=20=D1=80=D0=B0=D0=B1=D0=BE=D1=82?= =?UTF-8?q?=D0=BE=D0=B4=D0=B0=D1=82=D0=B5=D0=BB=D1=8F?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/employer_divisions.md | 63 ------------------------------ docs/employer_vacancies.md | 9 ++--- docs/manager_divisions.md | 79 ++++++++++++++++++++++++++++++++++++++ docs/resumes.md | 11 +++--- 4 files changed, 88 insertions(+), 74 deletions(-) delete mode 100644 docs/employer_divisions.md create mode 100644 docs/manager_divisions.md diff --git a/docs/employer_divisions.md b/docs/employer_divisions.md deleted file mode 100644 index 1c04f0b3..00000000 --- a/docs/employer_divisions.md +++ /dev/null @@ -1,63 +0,0 @@ -# Отделы работодателя - -* [Получение информации об отделах менеджера](#item) -* [Получение информации об отделе](#item) - -Для получения информации необходимо авторизоваться под работодателем. -Для пользователя без авторизации или для неправильно авторизованного пользователя вернется ответ `403 Forbidden`. - - - -## Получение информации об отделе - -### Запрос - -`GET /employers/{employer_id}/managers/{manager_id}/divisions` - -где: - -* `employer_id` - идентификатор работодателя, который можно узнать в - [информации о текущем пользователе](me.md#employer-info). -* `manager_id` - идентификатор менеджера. - -### Ответ - -В случае успешного выполнения запроса, будет возвращён статус `200 OK`. -В теле ответа будет содержаться информация об отделах менеджера, например: - -```json -{ - тут список отделов менеджера -} -``` - -### Ошибки -* `404 Not Found` - Работодатель или менеджер не найдены, или у пользователя нет прав - - - -## Получение информации об отделе - -### Запрос - -`GET /employers/{employer_id}/divisions/{division_id}` - -где: - -* `employer_id` - идентификатор работодателя, который можно узнать в - [информации о текущем пользователе](me.md#employer-info). -* `manager_id` - идентификатор менеджера. - -### Ответ - -В случае успешного выполнения запроса, будет возвращён статус `200 OK`. -В теле ответа будет содержаться информация об отделе, например: - -```json -{ - тут информация об отделе менеджера -} -``` - -### Ошибки -* `404 Not Found` - Работодатель или менеджер не найдены, или у пользователя нет прав diff --git a/docs/employer_vacancies.md b/docs/employer_vacancies.md index aee3add2..ba419027 100644 --- a/docs/employer_vacancies.md +++ b/docs/employer_vacancies.md @@ -23,17 +23,17 @@ ## Возможные варианты публикации вакансий у текущего менеджера Метод нужен, чтобы понять, может ли менеджер публиковать вакансии и какие типы вакансий ему доступны. Возвращает все возможные типы публикации. +> Внимание! Если в вашей компании используются отделы, то будут возвращены возможные варианты публикации [текущего отдела](manager_divisions.md#using-division). ### Запрос -```GET /employers/{employer_id}/managers/{manager_id}/vacancies/available_types?divisionId={division_id}``` +```GET /employers/{employer_id}/managers/{manager_id}/vacancies/available_types``` где: * `employer_id` - идентификатор работодателя, который можно узнать в [информации о текущем пользователе](me.md#employer-info). * `manager_id` - идентификатор менеджера. Можно узнать в [информации о текущем пользователе](me.md#manager-info). -* `division_id` - идентификатор отдела. ### Ответ @@ -141,6 +141,8 @@ publications[].areas_url | string | URL на список регионов, в * все вакансии проходят ручную модерацию. * в течение нескольких минут после публикации вакансия станет доступна в поиске. +>!! Внимание! Если в вашей компании используются отделы, то вакансия будет опубликована от лица [текущего отдела](manager_divisions.md#using-division). + ### Полезные ссылки @@ -223,9 +225,6 @@ publications[].areas_url | string | URL на список регионов, в "manager": { "id": "321" }, - "division": { - "id": "111" - }, "test": { "id": "42", "required": true diff --git a/docs/manager_divisions.md b/docs/manager_divisions.md new file mode 100644 index 00000000..01b35d5b --- /dev/null +++ b/docs/manager_divisions.md @@ -0,0 +1,79 @@ +# Отделы менеджера + +Менеджер может выполнять действия от лица нескольких отделов. Для взаимодействия с API в контексте определенного +отдела работодателя нужно использовать соответсвующий отдел. +У пользователя может быть несколько отделов, один из них является текущим. Какой отдел является текущим можно узнать, +получив [список отделов менеджера](#get-manager-divisions). Текущий отдела используется, если в качестве авторизации посылать только токен +(подробнее можно прочитать [здесь](#using-division)). + +* [Получение списка отделов пользователя](#get-manager-divisions) +* [Выбор отдела при запросах](#using-division) + + +## Получение списка отделов пользователя + +### Запрос + +``` +GET /manager_divisions/mine +``` + +### Ответ + +Успешный ответ приходит с кодом `200 OK` и содержит тело: + +```json +{ + "items": [ + { + "id": "1", + "name": "Департамент персонала" + }, + { + "id": "2", + "name": "Департамент продаж" + } + ], + "current_division_id": "2" +} +``` + +где: + +Имя | Тип | Описание +--- | --- | ------ +items | список | список отделов менеджера +current_division_id | строка | идентификатор текущего отдела (совпадает со значением переданного в заголовке) + + +#### Объект `division` + +Имя | Тип | Описание +--- | --- | ------ +id | строка | идентификатор отдела +name | строка | название отдела компании + +### Ошибки + +* `403 Forbidden` — ошибка авторизации (пользователь не является менеджером) + + + +## Выбор отдела при запросах + +Для работы под определенным отделом необходимо передать значение `division_id`, полученное из [списка](#get-manager-divisions), в заголовке: + +``` +X-Manager-Division-Id: {division_id} +``` + +Использовать данный заголовок можно во всех методах, доступных для работодателей. + +В заголовке можно передавать `division_id` текущего отдела, который также подразумевается по умолчанию, при отсутсвии заголовка. + + + +## Ошибки + +* `403 Forbidden` — отдел с переданным `division_id` не найден. Дополнительно к коду вернется причина ошибки +* `403 Forbidden` — ошибка авторизации (при запросах с авторизацией не работодателя) diff --git a/docs/resumes.md b/docs/resumes.md index 489ea072..9d194f07 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), включая тип видимости, комментарии модераторов и статус. @@ -1047,17 +1049,14 @@ expires | строка (дата) | время окончания действи }, "download_with_contact": { "pdf": { - "url": "https://hh.ru/api_resume_converter/12345678901234567890123456789012abcdef/ФамилияИмяОтчество.pdf?type=pdf&with_contact=2703892fa808bc3", - "division_id": 123 + "url": "https://hh.ru/api_resume_converter/12345678901234567890123456789012abcdef/ФамилияИмяОтчество.pdf?type=pdf&with_contact=2703892fa808bc3" }, "rtf": { - "url": "https://hh.ru/api_resume_converter/12345678901234567890123456789012abcdef/ФамилияИмяОтчество.rtf?type=rtf&with_contact=2703892fa808bc3", - "division_id": 123 + "url": "https://hh.ru/api_resume_converter/12345678901234567890123456789012abcdef/ФамилияИмяОтчество.rtf?type=rtf&with_contact=2703892fa808bc3" } }, "get_with_contact": { - "url": "https://api.hh.ru/resumes/12345678901234567890123456789012abcdef?with_contact=2703892fa808bc3", - "division_id": 123 + "url": "https://api.hh.ru/resumes/12345678901234567890123456789012abcdef?with_contact=2703892fa808bc3" } }, "paid_services": [ From f4a3e6c3b1a3e6a716de9efd271e84053d4e52ae Mon Sep 17 00:00:00 2001 From: vorobev Date: Wed, 10 Feb 2021 10:55:17 +0300 Subject: [PATCH 3/7] =?UTF-8?q?HH-123770=20'=D1=82=D0=B5=D0=BA=D1=83=D1=89?= =?UTF-8?q?=D0=B8=D0=B9'=20->=20'=D0=B2=D1=8B=D0=B1=D1=80=D0=B0=D0=BD?= =?UTF-8?q?=D0=BD=D1=8B=D0=B9'?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/employer_vacancies.md | 4 ++-- docs/resumes.md | 2 +- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/employer_vacancies.md b/docs/employer_vacancies.md index ba419027..13d76727 100644 --- a/docs/employer_vacancies.md +++ b/docs/employer_vacancies.md @@ -23,7 +23,7 @@ ## Возможные варианты публикации вакансий у текущего менеджера Метод нужен, чтобы понять, может ли менеджер публиковать вакансии и какие типы вакансий ему доступны. Возвращает все возможные типы публикации. -> Внимание! Если в вашей компании используются отделы, то будут возвращены возможные варианты публикации [текущего отдела](manager_divisions.md#using-division). +>!! Внимание! Если в вашей компании используются отделы, то будут возвращены возможные варианты публикации [выбранного отдела](manager_divisions.md#using-division). ### Запрос @@ -141,7 +141,7 @@ publications[].areas_url | string | URL на список регионов, в * все вакансии проходят ручную модерацию. * в течение нескольких минут после публикации вакансия станет доступна в поиске. ->!! Внимание! Если в вашей компании используются отделы, то вакансия будет опубликована от лица [текущего отдела](manager_divisions.md#using-division). +>!! Внимание! Если в вашей компании используются отделы, то вакансия будет опубликована от лица [выбранного отдела](manager_divisions.md#using-division). ### Полезные ссылки diff --git a/docs/resumes.md b/docs/resumes.md index 9d194f07..2c81cf4c 100644 --- a/docs/resumes.md +++ b/docs/resumes.md @@ -234,7 +234,7 @@ paid_services | object | [платные услуги по резюме для >!! Внимание произошли изменения в доступе к контактной информации. Прочитайте внимательно информацию про [поконтактный доступ к резюме](payable/resume.md#contact-data) ->!! Внимание! Если в вашей компании используются отделы, то контакт будет списан у [текущего отдела](manager_divisions.md#using-division). +>!! Внимание! Если в вашей компании используются отделы, то контакт будет списан у [выбранного отдела](manager_divisions.md#using-division). Для авторизованного автора возвращается [более детальная информация](#additional-author-fields), включая тип From 0925e7a33c8a6fed3ac157d4ef299cd08f1b0ed6 Mon Sep 17 00:00:00 2001 From: vorobev Date: Thu, 11 Feb 2021 10:38:49 +0300 Subject: [PATCH 4/7] =?UTF-8?q?HH-123770=20=D0=B4=D0=BE=D0=B1=D0=B0=D0=B2?= =?UTF-8?q?=D0=B8=D0=BB=20=D0=BE=D0=BF=D0=B8=D1=81=D0=B0=D0=BD=D0=B8=D0=B5?= =?UTF-8?q?=20=D0=BE=D1=88=D0=B8=D0=B1=D0=BE=D0=BA?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/errors.md | 6 ++++++ docs/manager_divisions.md | 3 ++- 2 files changed, 8 insertions(+), 1 deletion(-) 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 index 01b35d5b..75888251 100644 --- a/docs/manager_divisions.md +++ b/docs/manager_divisions.md @@ -75,5 +75,6 @@ X-Manager-Division-Id: {division_id} ## Ошибки -* `403 Forbidden` — отдел с переданным `division_id` не найден. Дополнительно к коду вернется причина ошибки * `403 Forbidden` — ошибка авторизации (при запросах с авторизацией не работодателя) +* `404 Not Found` — отдел с переданным `division_id` не найден +* [Дополнительные ошибки с описанием причины](/docs/errors.md#manager-divisions). From deeaed04dca11b9747ed43fb3aaf1e0c5b3adbce Mon Sep 17 00:00:00 2001 From: vorobev Date: Thu, 11 Feb 2021 12:03:11 +0300 Subject: [PATCH 5/7] =?UTF-8?q?HH-123770=20=D0=B4=D0=BE=D0=B1=D0=B0=D0=B2?= =?UTF-8?q?=D0=B8=D0=BB=20=D0=BF=D0=B5=D0=B9=D0=B4=D0=B6=D0=B8=D0=BD=D0=B3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/manager_divisions.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/docs/manager_divisions.md b/docs/manager_divisions.md index 75888251..cdfaf6c1 100644 --- a/docs/manager_divisions.md +++ b/docs/manager_divisions.md @@ -24,6 +24,10 @@ GET /manager_divisions/mine ```json { + "found": 2, + "page": 0, + "pages": 1, + "per_page": 2, "items": [ { "id": "1", From 4773b77137a52fb7eea1328063a0f110258b3ab0 Mon Sep 17 00:00:00 2001 From: vorobev Date: Thu, 11 Feb 2021 17:19:48 +0300 Subject: [PATCH 6/7] =?UTF-8?q?HH-123770=20=D0=B4=D0=BE=D0=B1=D0=B0=D0=B2?= =?UTF-8?q?=D0=B8=D0=BB=20=D0=BE=D1=82=D0=B4=D0=B5=D0=BB=20=D0=B2=20=D0=BF?= =?UTF-8?q?=D1=80=D0=BE=D1=81=D0=BC=D0=BE=D1=82=D1=80=20=D0=B8=20=D1=80?= =?UTF-8?q?=D0=B5=D0=B4=D0=B0=D0=BA=D1=82=D0=B8=D1=80=D0=BE=D0=B2=D0=B0?= =?UTF-8?q?=D0=BD=D0=B8=D0=B5=20=D0=B2=D0=B0=D0=BA=D0=B0=D0=BD=D1=81=D0=B8?= =?UTF-8?q?=D0=B8?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/employer_vacancies.md | 2 ++ docs/vacancies.md | 7 ++++++- 2 files changed, 8 insertions(+), 1 deletion(-) diff --git a/docs/employer_vacancies.md b/docs/employer_vacancies.md index 13d76727..f2cd2d04 100644 --- a/docs/employer_vacancies.md +++ b/docs/employer_vacancies.md @@ -578,6 +578,8 @@ Cоставные поля (например, `salary`, `contacts`, `specializat валюты в зарплате, необходимо передавать также и значения зарплаты, а для изменения специализации необходимо передать полный список. +>!! Внимание! При редактировании вакансии будет указан [выбранный отдел](manager_divisions.md#using-division). + ### Поля доступные для редактирования Имя | Описание 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). From 05917f9011692bc1911640d02cd639e1641e9338 Mon Sep 17 00:00:00 2001 From: vorobev Date: Sat, 20 Feb 2021 12:22:33 +0300 Subject: [PATCH 7/7] =?UTF-8?q?HH-123770=20404,=20=D0=B5=D1=81=D0=BB=D0=B8?= =?UTF-8?q?=20=D0=BD=D0=B5=D1=82=20=D0=BE=D1=82=D0=B4=D0=B5=D0=BB=D0=BE?= =?UTF-8?q?=D0=B2?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/manager_divisions.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/manager_divisions.md b/docs/manager_divisions.md index cdfaf6c1..2983690a 100644 --- a/docs/manager_divisions.md +++ b/docs/manager_divisions.md @@ -60,6 +60,7 @@ name | строка | название отдела компании ### Ошибки * `403 Forbidden` — ошибка авторизации (пользователь не является менеджером) +* `404 Not Found` — нет отделов у менеджера