From c35ef63ac5e23b194e6f619087ce1026bfc4c868 Mon Sep 17 00:00:00 2001 From: Daniil_Idrisov Date: Thu, 7 Mar 2024 15:47:28 +0300 Subject: [PATCH 1/2] =?UTF-8?q?=D0=9F=D0=B5=D1=80=D0=B5=D0=B2=D0=B5=D0=BB?= =?UTF-8?q?=D0=B8=20=D0=BE=D1=82=D0=BF=D1=80=D0=B0=D0=B2=D0=BA=D1=83=20?= =?UTF-8?q?=D1=81=D0=BE=D0=BE=D0=B1=D1=89=D0=B5=D0=BD=D0=B8=D1=8F=20=D0=B2?= =?UTF-8?q?=20=D0=BE=D1=82=D0=BA=D0=BB=D0=B8=D0=BA=D0=B5/=D0=BF=D1=80?= =?UTF-8?q?=D0=B8=D0=B3=D0=BB=D0=B0=D1=88=D0=B5=D0=BD=D0=B8=D0=B8=20=D0=B2?= =?UTF-8?q?=20OpenAPI?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/employer_negotiations.md | 40 +---------------------------------- 1 file changed, 1 insertion(+), 39 deletions(-) diff --git a/docs/employer_negotiations.md b/docs/employer_negotiations.md index 2c4be3b1..41f01b44 100644 --- a/docs/employer_negotiations.md +++ b/docs/employer_negotiations.md @@ -878,45 +878,7 @@ assessments | массив | [инструменты оценки](assessment.md ## Отправка сообщения в отклике/приглашении -Обмен сообщениями возможен после приглашения соискателя. О возможности написать -сообщение можно узнать из -[поля `messages_status` в отклике/приглашении](#messaging_status). - -### Запрос - -`POST /negotiations/{nid}/messages` - -где `nid` – идентификатор отклика/приглашения. - -Дополнительно необходимо передать параметр `message` - текст сообщения. - -### Ответ - -Успешный ответ приходит с кодом `201 Created` и не содержит тело. - -### Ошибки - -* `400 Bad Request` – ошибка в параметрах запроса. -* `403 Forbidden` – отправка сообщения невозможна. -* `404 Not Found` – переданный отклик/приглашение не существует, либо у - текущего менеджера нет прав для работы с ним. - -Дополнительно к HTTP коду сервер может вернуть описание -[причины ошибки](errors.md#negotiations). - -Например: - -* `resume_not_found` – если резюме в отклике/приглашении было скрыто - либо удалено -* `invalid_vacancy` – если вакансия в отклике/приглашении была архивирована - либо скрыта -* `no_invitation` – если отклик/приглашение не в статусе «приглашение». - Например, уже в статусе «отказано» или ещё в статусе «отклик». -* `in_a_row_limit` – если превышено количество последовательных сообщений. - Соискатель должен ответить на сообщение, чтобы появилась возможность писать - вновь. -* `overall_limit` – если превышен лимит сообщений - +> !! Данный метод доступен в [OpenAPI](https://api.hh.ru/openapi/redoc#tag/Otklikipriglasheniya-rabotodatelya/operation/send-negotiation-message) ## Приглашение соискателя на вакансию From ae3299dd532a8ee511ef03be748d86158db42fea Mon Sep 17 00:00:00 2001 From: Daniil_Idrisov Date: Thu, 7 Mar 2024 15:48:02 +0300 Subject: [PATCH 2/2] Moved sending a message in the response/invitation to OpenAPI --- docs_eng/employer_negotiations.md | 42 +------------------------------ 1 file changed, 1 insertion(+), 41 deletions(-) diff --git a/docs_eng/employer_negotiations.md b/docs_eng/employer_negotiations.md index bd1608bc..066d140d 100644 --- a/docs_eng/employer_negotiations.md +++ b/docs_eng/employer_negotiations.md @@ -890,47 +890,7 @@ If response/invitation doesn't exist or negotiation not available to the current ## Sending a message in the response/invitation -Messaging is possible after invitation of the applicant. Find out whether you can -leave the message from -[field `messages_status` in response/invitation](#messaging_status). - -### Request - -``` -POST /negotiations/{nid}/messages -``` - -where `nid` is the response/invitation ID. - -Additionally, the `message` parameter – message text – must be specified. - -### Response - -Successful server response is returned with `201 Created` code and does not have a body. - -### Errors - -* `400 Bad Request` – error in the request parameters. -* `403 Forbidden` – message cannot be sent. -* `404 Not Found` – sent response/invitation doesn't exist or current - manager is not authorized to process it. - -In addition to an HTTP code, the server can return -[error reason](errors.md#negotiations). - -For example: - -* `resume_not_found` – if the CV in the response/invitation was hidden - or deleted -* `invalid_vacancy` – if the vacancy in the response/invitation was archived - or hidden -* `no_invitation` – if the response/invitation is not in the "invitation" status. - For example, it is already in the "rejected" status or still in the "response" status. -* `in_a_row_limit` – if the number of successive messages is exceeded. - The applicant must reply to the message in order the employer is able to send - new messages. -* `overall_limit` – if the messages limit is exceeded - +>!! Method is defined in [OpenAPI](https://api.hh.ru/openapi/en/redoc#tag/Employer-responsesinvitations/operation/send-negotiation-message) ## Inviting an applicant for a vacancy