Skip to content

Latest commit

 

History

History
148 lines (114 loc) · 9.38 KB

employer_negotiations_statistics.md

File metadata and controls

148 lines (114 loc) · 9.38 KB

Статистика по работе с откликами

Для получения информации необходимо авторизоваться под работодателем. Для пользователя без авторизации или для неправильно авторизованного пользователя вернется ответ 403 Forbidden. Статистика менеджера доступна самому менеджеру, а также менеджерам с типом main_contact_person.

Статистика работодателя

Запрос

GET /employers/{employer_id}/negotiations_statistics

где employer_id - идентификатор работодателя, который можно узнать в информации о текущем пользователе.

Ответ

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

{
    "employer_statistics": {
        "received": 20,
        "viewed_percent": 23,
        "viewed_percent_change": 10,
        "replied_percent": 0,
        "replied_percent_change": -15,
        "average_reply_time": 1.0,
        "politeness": {
            "index": 62,
            "index_change": -1,
            "hint": "Ваш Индекс вежливости выше среднего — это хороший показатель, и все же он может быть лучше!",
            "description": "Индекс вежливости видят соискатели после отклика на вакансию. Компании с низким Индексом теряют доверие соискателей и рискуют пропустить подходящих кандидатов.",
            "article_url": "https://hh.ru/article/23734"
        }
    }
}

Объект employer_statistics

Содержит статистику по откликам компании.

Имя Тип Описание
received number количество откликов на вакансии работодателя, полученных за последние 30 дней (далее период)
viewed_percent number или null процент прочитанных откликов на вакансии работодателя за период или null при отсутствии откликов
viewed_percent_change number или null изменение viewed_percent по сравнению с предыдущим периодом или null при отсутствии откликов
replied_percent number или null процент откликов на вакансии работодателя, перемещенных в любую другую коллекцию с отправкой сообщения за период или null при отсутствии откликов
replied_percent_change number или null изменение replied_percent по сравнению с предыдущим периодом или null при отсутствии откликов
average_reply_time number или null среднее время в днях между получением отклика на вакансии работодателя и отправкой сообщения или null при отсутствии отправленных сообщений
politeness object или null Объект politeness или null, если индекс вежливости компании рассчитать нельзя, например, пока нет ни одной вакансии или отклика

Объект politeness для компании

Содержит информацию об индексе вежливости компании.

Имя Тип Описание
index number значение индекса вежливости компании
index_change number изменение индекса вежливости компании по сравнению с предыдущим периодом
hint string краткое описание текущего значения индекса вежливости компании
description string краткое описание понятия индекса вежливости
article_url string url статьи про индекс вежливости

Ошибки

  • 404 Not found - Работодатель не найден, или у пользователя нет прав

Статистика менеджера

Запрос

GET /employers/{employer_id}/managers/{manager_id}/negotiations_statistics

где:

Ответ

Пример ответа:

{
    "manager_statistics": {
        "received": 20,
        "viewed_percent": 23,
        "viewed_percent_change": 10,
        "replied_percent": 0,
        "replied_percent_change": -15,
        "average_reply_time": 1.0,
        "politeness": {
            "index": 19,
            "index_change": 0,
            "hint": "У вас низкий Индекс вежливости, но вы можете его повысить!",
            "description": "Индекс вежливости видят соискатели после отклика на вакансию. Компании с низким Индексом теряют доверие соискателей и рискуют пропустить подходящих кандидатов.",
            "article_url": "https://hh.ru/article/23734"
        }
    }
}

Объект manager_statistics

Содержит статистику по откликам менеджера.

Имя Тип Описание
received number количество откликов на вакансии менеджера, полученных за последние 30 дней (далее период)
viewed_percent number или null процент прочитанных откликов на вакансии менеджера за период или null при отсутствии откликов
viewed_percent_change number или null изменение viewed_percent по сравнению с предыдущим периодом или null при отсутствии откликов
replied_percent number или null процент откликов на вакансии менеджера, перемещенных в любую другую коллекцию с отправкой сообщения за период или null при отсутствии откликов
replied_percent_change number или null изменение replied_percent по сравнению с предыдущим периодом или null при отсутствии откликов
average_reply_time number или null среднее время в днях между получением отклика на вакансии менеджера и отправкой сообщения или null при отсутствии отправленных сообщений
politeness object или null Объект politeness или null, если индекс вежливости менеджера рассчитать нельзя, например, у него пока нет ни одной вакансии или отклика

Объект politeness для менеджера

Содержит информацию по индексу вежливости менеджера.

Имя Тип Описание
index number значение индекса вежливости менеджера
index_change number изменение индекса вежливости менеджера по сравнению с предыдущим периодом
hint string краткое описание текущего значения индекса вежливости менеджера
description string краткое описание понятия индекса вежливости
article_url string url статьи про индекс вежливости

Ошибки

  • 404 Not found - Работодатель или менеджер не найден, или у пользователя нет прав.