Skip to content

Latest commit

 

History

History
126 lines (101 loc) · 7.32 KB

employers.md

File metadata and controls

126 lines (101 loc) · 7.32 KB

Работодатели/компании

## Поиск компаний

GET /employers вернёт результаты поиска компаний.

Возможные параметры:

  • text - текстовое поле, переданное значение ищется в названии и описании компании
  • area - множественный параметр, идентификатор региона работодателя. Идентификаторы регионов можно узнать в справочнике регионов
  • type - множественный параметр, типы работодателей. Разрешенные значения - ключи в разделе employer_type в /dictionaries
  • only_with_vacancies - возвращать только работодателей у которых есть в данный момент открытые вакансии (true) или же всех (false), по умолчанию - false
  • page - номер страницы с работодателями (считается от 0, по умолчанию - 0)
  • per_page - количество элементов на страницу (по умолчанию - 20)

Максимальное количество выданных работодателей - 2000.

Ответ:

{
    "per_page": 20,
    "page": 0,
    "pages": 1,
    "found": 1,
    "items": [
        {
            "id": "1455",
            "name": "HeadHunter",
            "url": "https://api.hh.ru/employers/1455",
            "alternate_url": "http://hh.ru/employer/1455",
            "vacancies_url": "https://api.hh.ru/vacancies?employer_id=1455",
            "open_vacancies": 19,
            "logo_urls": {
              "90":  "http://hh.ru/employer-logo/289027.png"
            }
        }
    ]
}
Имя Тип Описание
per_page число количество отображаемых на страницу элементов
page число номер отображаемой страницы
pages число количество страниц с данными
found число количество работодателей, найденных по переданному поисковому критерию
items массив объектов найденные работодатели (максимум per_page элементов)

Каждый элемент массива items содержит в себе короткое представление работодателя с дополнительным указанием количества открытых вакансий.

Имя Тип Описание
id строка идентификатор работодателя
name строка название работодателя
url строка ссылка на детальное описание работодателя
alternate_url строка ссылка на описание работодателя на сайте
vacancies_url строка cсылка на поисковую выдачу вакансий данной компании
open_vacancies число количество открытых вакансий у работодателя
logo_urls объект, null логотипы компании (см. ниже)

В случае, когда в параметрах были переданы неправильные значения, будет возвращён код ответа 400 Bad Request. При этом в теле ответа будет содержаться информация о том, в каком параметре была допущена ошибка.

Например: на запрос https://api.hh.ru/employers?type=abracadabra придёт ответ 400 Bad Request с телом:

{
    "bad_arguments": [
        {
            "name": "type",
            "description": "unknown type"
        }
     ]
}
## Работодатель / компания

GET /employers/{employer_id} возвращает данные о компании с ссылкой на выдачу вакансий этой компании.

{
	"name": "HeadHunter",
	"type": "company",
	"id": "1455",
	"site_url": "http://hh.ru",
	"description": "...",
	"branded_description": "<style>...</style><div>...</div><script></script>",
	"vacancies_url": "https://api.hh.ru/vacancies?employer_id=1455",
	"trusted": true,
	"alternate_url": "http://hh.ru/employer/1455",
	"logo_urls": {
		"90": "http://hh.ru/employer-logo/289027.png",
		"240": "http://hh.ru/employer-logo/289169.png",
		"original": "http://hh.ru/file/2352807.png"
	}
}

branded_description - строка с кодом HTML (возможно наличие <script/> и <style/>), которая является альтернативой стандартному описанию компании. HTML адаптирован для мобильных устройств и корректно отображается без поддержки javascript. При этом:

  • Контент тянется по ширине на 100% ширины контейнера и умещается без прокрутки в 300px.
  • Контент рассчитан на то, что он будет вставлен в обвязку, в которую входит название, логотип, сайт и ссылка на вакансии компании.
  • Изображения, которые могут встретиться в таком описании, адаптированы под retina дисплеи.
  • Размер шрифта не меньше 12px, размер межстрочного интервала не меньше 16px.

Значение может быть null, если у компании отсутствует индивидуальное описание.

vacancies_url — ссылка на поисковую выдачу вакансий данной компании.

logo_urls — изображения логотипа компании разных размеров. original — это необработанный логотип, который может быть большого размера. Если изначально загруженный компанией логотип меньше, чем 240px и/или 90px по меньшей стороне, то в соответствующих ключах будут ссылки на изображения оригинального размера. Объект может быть null, если компания не загрузила логотип. Клиент должен предусмотреть возможность отсутствия логотипа по указанной ссылке (ответ с кодом 404 Not Found).

type — тип компании (прямой работодатель, кадровое агентство и т.п.). Возможные значения описаны в коллекции справочников под ключом employer_type.

Пример: https://api.hh.ru/employers/1455