Skip to content

Commit

Permalink
Перевели просмотр отклика/приглашения в OpenAPI
Browse files Browse the repository at this point in the history
  • Loading branch information
@DaniilIdrisov
DaniilIdrisov committed Apr 11, 2024
1 parent 1e9e449 commit 040fd8f
Showing 1 changed file with 1 addition and 241 deletions.
242 changes: 1 addition & 241 deletions docs/employer_negotiations.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -492,247 +492,7 @@ required_arguments | список | Аргументы, которые необ
<a name="get-negotiation"></a>
## Просмотр отклика/приглашения

Для того, чтобы просмотреть полную информацию об отклике необходимо перейти по урлу (поле `items[].url`),
полученному в [списке откликов/приглашений](#negotiations-list), например:

`GET /negotiations/123456789`

### Ответ

Успешный ответ приходит с кодом `200 OK` и содержит:

```json
{
"id": "123456789",
"created_at": "2015-05-14T00:00:00+0300",
"updated_at": "2015-05-14T12:00:05+0300",
"has_updates": true,
"messages_url": "https://api.hh.ru/negotiations/123456789/messages",
"messaging_status": "ok",
"state": {
"id": "response",
"name": "Отклик"
},
"employer_state": {
"id": "response",
"name": "Отклик"
},
"actions": [
{
"id": "invitation",
"name": "Пригласить",
"enabled": true,
"method": "PUT",
"url": "https://api.hh.ru/negotiations/somecollection/123456789",
"resulting_employer_state": {
"id": "invitation",
"name": "Приглашение"
},
"templates": [
{
"id": "invite_after_response",
"name": "Приглашение откликнувшегося соискателя",
"quick": false,
"url": "https://api.hh.ru/message_templates/invite_after_response?topic_id=123456789"
}
],
"arguments": [
{
"id": "message",
"required": true,
"required_arguments": []
},
{
"id": "send_sms",
"required": false,
"required_arguments": [
{
"id": "message"
}
]
},
{
"id": "address_id",
"required": false,
"required_arguments": [
{
"id": "message"
}
]
}
]
},
{
"id": "hold",
"name": "Подумать",
"enabled": true,
"method": "PUT",
"url": "https://api.hh.ru/negotiations/hold/123456789",
"arguments": [],
"resulting_employer_state": null,
"templates": []
}
],
"viewed_by_opponent": false,
"resume": {
"id": "0123456789abcdef",
"title": "Начинающий специалист",
"url": "https://api.hh.ru/resumes/0123456789abcdef?topic_id=123456789",
"first_name": "Иван",
"last_name": "Иванов",
"middle_name": "Иванович",
"age": 19,
"alternate_url": "https://hh.ru/resume/0123456789abcdef?vacancyId=123456&t=123456789",
"created_at": "2015-02-06T12:00:00+0300",
"updated_at": "2015-04-20T16:24:15+0300",
"area": {
"id": "1",
"name": "Москва",
"url": "https://api.hh.ru/areas/1"
},
"certificate": [
{
"achieved_at": "2015-01-01",
"owner": null,
"title": "тест",
"type": "custom",
"url": "http://example.com/"
}
],
"education": {
"primary": [
{
"name": "Российский государственный социальный университет, Москва",
"name_id": "39420",
"organization": "Факультет информационных технологий",
"organization_id": null,
"result": "",
"result_id": null,
"year": 2012
}
],
"level": {
"id": "higher",
"name": "Высшее"
}
},
"total_experience": {
"months": 118
},
"experience": [
{
"area": {
"id": "1",
"name": "Москва",
"url": "https://api.hh.ru/areas/1"
},
"company": "Рога и копыта",
"company_id": null,
"company_url": "http://example.com/",
"employer": null,
"end": "1999-03-01",
"industries": [
{
"id": "45.507",
"name": "Добыча и обогащение руд черных, цветных, драгоценных, благородных, редких металлов"
}
],
"industry": null,
"start": "1998-01-01"
}
],
"gender": {
"id": "male",
"name": "Мужской"
},
"salary": {
"amount": 1000000,
"currency": "RUR"
},
"owner": {
"id": "123456",
"comments": {
"url": "https://api.hh.ru/applicant_comments/123456",
"counters": {
"total": 7
}
}
},
"negotiations_history": {
"url": "https://api.hh.ru/resumes/0123456789abcdef/negotiations_history"
},
"download": {
"pdf": {
"url": "https://hh.ru/api_resume_converter/0123456789abcdef/ИвановИванИванович.pdf?type=pdf"
},
"rtf": {
"url": "https://hh.ru/api_resume_converter/0123456789abcdef/ИвановИванИванович.rtf?type=rtf"
}
}
},
"vacancy": {
"address": null,
"alternate_url": "https://hh.ru/vacancy/123456",
"archived": false,
"area": {
"id": "1",
"name": "Москва",
"url": "https://api.hh.ru/areas/1"
},
"created_at": "2015-05-14T11:00:00+0300",
"employer": {
"alternate_url": "https://hh.ru/employer/1",
"id": "1",
"logo_urls": {
"240": "https://hh.ru/employer-logo/1111.jpeg",
"90": "https://hh.ru/employer-logo/1111.jpeg",
"original": "https://hh.ru/employer-logo-original/1111.jpeg"
},
"name": "Рога и копыта",
"url": "https://api.hh.ru/employers/1",
"vacancies_url": "https://api.hh.ru/vacancies?employer_id=1"
},
"id": "123456",
"name": "Менеджер",
"premium": false,
"published_at": "2015-05-14T10:00:00+0300",
"response_letter_required": false,
"salary": null,
"type": {
"id": "closed",
"name": "Закрытая"
},
"url": "https://api.hh.ru/vacancies/123456?host=hh.ru"
},
"counters": {
"messages": 100,
"unread_messages": 50
},
"source": "NEGOTIATION",
"test_result": {
"url": "https://api.hh.ru/negotiations/1359970704/test/solution",
"alternate_url": "https://hh.ru/employer/vacancy_response/test?topicId=1359970704",
"score": 100,
"mark": "EXCELLENT"
}
}
```

Тело ответа аналогично
[элементу в списке откликов/приглашений](#negotiations-list-item), а также
содержит ключ `vacancy` в котором выдаётся
[краткая информация о вакансии](vacancies.md#nano).

<a name="messaging_status"></a>
Дополнительно по отклику/приглашению возвращаются поля `messaging_status`,
которое указывает на состояние переписки ([возможные значения](https://api.hh.ru/openapi/redoc#tag/Obshie-spravochniki/operation/get-dictionaries)), и `professional_roles`,
содержащее список профессиональных ролей ([возможные значения](https://api.hh.ru/openapi/redoc#tag/Obshie-spravochniki/operation/get-professional-roles-dictionary)).


### Ошибки

* `404 Not Found` - отклик/приглашение не существует или недоступен текущему пользователю

> !! Данный метод доступен в [OpenAPI](https://api.hh.ru/openapi/redoc#tag/Otklikipriglasheniya-rabotodatelya/operation/get-negotiation-item)
## Просмотр списка сообщений в отклике/приглашении

Expand Down

0 comments on commit 040fd8f

Please sign in to comment.