Go API client for hh

В OpenAPI ведется пока что только небольшая часть документации Основная документация.

Для поиска по документации можно использовать Ctrl+F.

Общая информация

Всё API работает по протоколу HTTPS.
Авторизация осуществляется по протоколу OAuth2.
Все данные доступны только в формате JSON.
Базовый URL — https://api.hh.ru/
Возможны запросы к данным любого сайта группы компаний HeadHunter
<a name="date-format"> Даты форматируются в соответствии с ISO 8601: YYYY-MM-DDThh:mm:ss±hhmm.

Требования к запросам

В запросе необходимо передавать заголовок User-Agent, но если ваша реализация http клиента не позволяет, можно отправить HH-User-Agent. Если не отправлен ни один заголовок, то ответом будет 400 Bad Request. Указание в заголовке названия приложения и контактной почты разработчика позволит нам оперативно с вами связаться в случае необходимости. Заголовки User-Agent и HH-User-Agent взаимозаменяемы, в случае, если вы отправите оба заголовка, обработан будет только HH-User-Agent.

User-Agent: MyApp/1.0 (my-app-feedback@example.com)

Подробнее про ошибки в заголовке User-Agent.

Формат тела запроса при отправке JSON

Данные, передающиеся в теле запроса, должны удовлетворять требованиям:

Валидный JSON (допускается передача как минифицированного варианта, так и pretty print варианта с дополнительными пробелами и сбросами строк).
Рекомендуется использование кодировки UTF-8 без дополнительного экранирования ({\"name\": \"Иванов Иван\"}).
Также возможно использовать ascii кодировку с экранированием ({\"name\": \"\\u0418\\u0432\\u0430\\u043d\\u043e\\u0432 \\u0418\\u0432\\u0430\\u043d\"}).
К типам данных в определённым полях накладываются дополнительные условия, описанные в каждом конкретном методе. В JSON типами данных являются string, number, boolean, null, object, array.

Ответ

Ответ свыше определенной длины будет сжиматься методом gzip.

Ошибки и коды ответов

API широко использует информирование при помощи кодов ответов. Приложение должно корректно их обрабатывать.

В случае неполадок и сбоев, возможны ответы с кодом 503 и 500.

При каждой ошибке, помимо кода ответа, в теле ответа может быть выдана дополнительная информация, позволяющая разработчику понять причину соответствующего ответа.

Более подробно про возможные ошибки.

Недокументированные поля и параметры запросов

В ответах и параметрах API можно найти ключи, не описанные в документации. Обычно это означает, что они оставлены для совместимости со старыми версиями. Их использование не рекомендуется. Если ваше приложение использует такие ключи, перейдите на использование актуальных ключей, описанных в документации.

Пагинация

К любому запросу, подразумевающему выдачу списка объектов, можно в параметрах указать page=N&per_page=M. Нумерация идёт с нуля, по умолчанию выдаётся первая (нулевая) страница с 20 объектами на странице. Во всех ответах, где доступна пагинация, единообразный корневой объект:

{
  \"found\": 1,
  \"per_page\": 1,
  \"pages\": 1,
  \"page\": 0,
  \"items\": [{}]
}

Выбор сайта

API HeadHunter позволяет получать данные со всех сайтов группы компании HeadHunter.

В частности:

hh.ru
rabota.by
hh1.az
hh.uz
hh.kz
headhunter.ge
headhunter.kg

Запросы к данным на всех сайтах следует направлять на https://api.hh.ru/.

При необходимости учесть специфику сайта, можно добавить в запрос параметр ?host=. По умолчанию используется hh.ru.

Например, для получения локализаций, доступных на hh.kz необходимо сделать GET запрос на https://api.hh.ru/locales?host=hh.kz.

CORS (Cross-Origin Resource Sharing)

API поддерживает технологию CORS для запроса данных из браузера с произвольного домена. Этот метод более предпочтителен, чем использование JSONP. Он не ограничен методом GET. Для отладки CORS доступен специальный метод. Для использования JSONP передайте параметр ?callback=callback_name.

Внешние ссылки на статьи и стандарты

Авторизация

API поддерживает следующие уровни авторизации:

авторизация приложения
авторизация пользователя

Авторизация пользователя
Обновление пары access и refresh токенов
Инвалидация токена
Запрос авторизации под другим пользователем
Авторизация под разными рабочими аккаунтами
Авторизация приложения

Авторизация пользователя

Для выполнения запросов от имени пользователя необходимо пользоваться токеном пользователя.

В начале приложению необходимо направить пользователя (открыть страницу) по адресу:

https://hh.ru/oauth/authorize?
response_type=code&
client_id={client_id}&
state={state}&
redirect_uri={redirect_uri}

Обязательные параметры:

response_type=code — указание на способ получения авторизации, используя authorization code
client_id — идентификатор, полученный при создании приложения

Необязательные параметры:

state — в случае указания, будет включен в ответный редирект. Это позволяет исключить возможность взлома путём подделки межсайтовых запросов. Подробнее об этом: RFC 6749. Section 10.12
redirect_uri — uri для перенаправления пользователя после авторизации. Если не указать, используется из настроек приложения. При наличии происходит валидация значения. Вероятнее всего, потребуется сделать urlencode значения параметра.

Правила формирования специального redirect_uri

К примеру, если в настройках сохранен http://example.com/oauth, то разрешено указывать:

http://www.example.com/oauth — поддомен;
http://www.example.com/oauth/sub/path — уточнение пути;
http://example.com/oauth?lang=RU — дополнительный параметр;
http://www.example.com/oauth/sub/path?lang=RU — всё вместе.

Запрещено:

https://example.com/oauth — различные протоколы;
http://wwwexample.com/oauth — различные домены;
http://wwwexample.com/ — другой путь;
http://example.com/oauths — другой путь;
http://example.com:80/oauths — указание изначально отсутствующего порта;

Процесс авторизации

Если пользователь не авторизован на сайте, ему будет показана форма авторизации на сайте. После прохождения авторизации на сайте, пользователю будет выведена форма с запросом разрешения доступа вашего приложения к его персональным данным.

Если пользователь не разрешает доступ приложению, пользователь будет перенаправлен на указанный redirect_uri с ?error=access_denied и state={state}, если таковой был указан при первом запросе.

Успешное получение временного `authorization_code`

В случае разрешения прав, в редиректе будет указан временный authorization_code:

HTTP/1.1 302 FOUND
Location: {redirect_uri}?code={authorization_code}

Если пользователь авторизован на сайте и доступ данному приложению однажды ранее выдан, ответом будет сразу вышеописанный редирект с authorization_code (без показа формы логина и выдачи прав).

Получение access и refresh токенов

После получения authorization_code приложению необходимо сделать сервер-сервер запрос POST https://api.hh.ru/token для обмена полученного authorization_code на access_token (старый запрос POST https://hh.ru/oauth/token считается устаревшим).

В теле запроса необходимо передать дополнительные параметры.

Тело запроса необходимо передавать в стандартном application/x-www-form-urlencoded с указанием соответствующего заголовка Content-Type.

authorization_code имеет довольно короткий срок жизни, при его истечении необходимо запросить новый.

Обновление пары access и refresh токенов

access_token также имеет срок жизни (ключ expires_in, в секундах), при его истечении приложение должно сделать запрос с refresh_token для получения нового.

Запрос необходимо делать в application/x-www-form-urlencoded.

POST https://api.hh.ru/token

(старый запрос POST https://hh.ru/oauth/token считается устаревшим)

В теле запроса необходимо передать дополнительные параметры

refresh_token можно использовать только один раз и только по истечению срока действия access_token.

После получения новой пары access и refresh токенов, их необходимо использовать в дальнейших запросах в api и запросах на продление токена.

Запрос авторизации под другим пользователем

Возможен следующий сценарий:

Приложение перенаправляет пользователя на сайт с запросом авторизации.
Пользователь на сайте уже авторизован и данному приложение доступ уже был разрешен.
Пользователю будет предложена возможность продолжить работу под текущим аккаунтом, либо зайти под другим аккаунтом.

Если есть необходимость, чтобы на шаге 3 сразу происходило перенаправление (redirect) с временным токеном, необходимо добавить к запросу /oauth/authorize... параметр skip_choose_account=true. В этом случае автоматически выдаётся доступ пользователю авторизованному на сайте.

Если есть необходимость всегда показывать форму авторизации, приложение может добавить к запросу /oauth/authorize... параметр force_login=true. В этом случае, пользователю будет показана форма авторизации с логином и паролем даже в случае, если пользователь уже авторизован.

Это может быть полезно приложениям, которые предоставляют сервис только для соискателей. Если пришел пользователь-работодатель, приложение может предложить пользователю повторно разрешить доступ на сайте, уже указав другую учетную запись.

Также, после авторизации приложение может показать пользователю сообщение:

Вы вошли как %Имя_Фамилия%. Это не вы?

и предоставить ссылку с force_login=true для возможности захода под другим логином.

Авторизация под разными рабочими аккаунтами

Для получения списка рабочих аккаунтов менеджера и для работы под разными рабочими аккаунтами менеджера необходимо прочитать документацию по рабочим аккаунтам менеджера

В случае компрометации токена необходимо инвалидировать скомпрометированный токен и запросить токен заново!

Overview

This API client was generated by the OpenAPI Generator project. By using the OpenAPI-spec from a remote server, you can easily generate an API client.

API version: 1.0.0
Package version: 1.0.0
Generator version: 7.9.0-SNAPSHOT
Build package: org.openapitools.codegen.languages.GoClientCodegen For more information, please visit https://api.hh.ru/openapi/redoc

Installation

Install the following dependencies:

go get github.com/stretchr/testify/assert
go get golang.org/x/net/context

Put the package under your project folder and add the following in import:

import hh "github.com/zaboal/hh-go"

To use a proxy, set the environment variable HTTP_PROXY:

os.Setenv("HTTP_PROXY", "http://proxy_name:proxy_port")

Configuration of Server URL

Default configuration comes with Servers field that contains server objects as defined in the OpenAPI specification.

Select Server Configuration

For using other server than the one defined on index 0 set context value hh.ContextServerIndex of type int.

ctx := context.WithValue(context.Background(), hh.ContextServerIndex, 1)

Templated Server URL

Templated server URL is formatted using default variables from configuration or from context value hh.ContextServerVariables of type map[string]string.

ctx := context.WithValue(context.Background(), hh.ContextServerVariables, map[string]string{
	"basePath": "v2",
})

Note, enum values are always validated and all unused variables are silently ignored.

URLs Configuration per Operation

Each operation can use different server URL defined using OperationServers map in the Configuration. An operation is uniquely identified by "{classname}Service.{nickname}" string. Similar rules for overriding default operation server index and variables applies by using hh.ContextOperationServerIndices and hh.ContextOperationServerVariables context maps.

ctx := context.WithValue(context.Background(), hh.ContextOperationServerIndices, map[string]int{
	"{classname}Service.{nickname}": 2,
})
ctx = context.WithValue(context.Background(), hh.ContextOperationServerVariables, map[string]map[string]string{
	"{classname}Service.{nickname}": {
		"port": "8443",
	},
})

Documentation for API Endpoints

All URIs are relative to https://api.hh.ru

Class	Method	HTTP request	Description
DefaultApi	AddApplicantComment	Post /applicant_comments/{applicant_id}	Добавление комментария
DefaultApi	AddApplicantComment_0	Post /applicant_comments/{applicant_id}	Добавление комментария
DefaultApi	AddEmployerManager	Post /employers/{employer_id}/managers	Добавление менеджера
DefaultApi	AddEmployerToBlacklisted	Put /employers/blacklisted/{employer_id}	Добавление работодателя в список скрытых
DefaultApi	AddResumeVisibilityList	Post /resumes/{resume_id}/{list_type}	Добавление работодателей в список видимости
DefaultApi	AddVacancyToArchive	Put /employers/{employer_id}/vacancies/archived/{vacancy_id}	Архивация вакансии
DefaultApi	AddVacancyToArchive_0	Put /employers/{employer_id}/vacancies/archived/{vacancy_id}	Архивация вакансии
DefaultApi	AddVacancyToBlacklisted	Put /vacancies/blacklisted/{vacancy_id}	Добавление вакансии в список скрытых
DefaultApi	AddVacancyToFavorite	Put /vacancies/favorited/{vacancy_id}	Добавление вакансии в список отобранных
DefaultApi	AddVacancyToHidden	Put /employers/{employer_id}/vacancies/hidden/{vacancy_id}	Удаление вакансий
DefaultApi	ApplyToVacancy	Post /negotiations	Отклик на вакансию
DefaultApi	Authorize	Post /oauth/token	Получение access-токена
DefaultApi	Authorize_0	Post /oauth/token	Получение access-токена
DefaultApi	Authorize_1	Post /oauth/token	Получение access-токена
DefaultApi	ChangeNegotiationAction	Put /negotiations/{collection_name}/{nid}	Действия по отклику/приглашению коллекции
DefaultApi	ChangeNegotiationAction_0	Put /negotiations/{collection_name}/{nid}	Действия по отклику/приглашению коллекции
DefaultApi	ChangeVacancyDraft	Put /vacancies/drafts/{draft_id}	Изменение черновика вакансии
DefaultApi	ConfirmPhoneInResume	Post /resume_phone_confirm	Подтвердить телефон кодом
DefaultApi	CreateResume	Post /resumes	Создание резюме
DefaultApi	CreateSavedResumeSearch	Post /saved_searches/resumes	Создание нового сохраненного поиска резюме
DefaultApi	CreateSavedVacancySearch	Post /saved_searches/vacancies	Создание нового сохраненного поиска вакансий
DefaultApi	CreateVacancyDraft	Post /vacancies/drafts	Создание черновика вакансии
DefaultApi	DeleteApplicantComment	Delete /applicant_comments/{applicant_id}/{comment_id}	Удаление комментария
DefaultApi	DeleteApplicantComment_0	Delete /applicant_comments/{applicant_id}/{comment_id}	Удаление комментария
DefaultApi	DeleteArtifact	Delete /artifacts/{id}	Удаление артефакта
DefaultApi	DeleteEmployerFromBlacklisted	Delete /employers/blacklisted/{employer_id}	Удаление работодателя из списка скрытых
DefaultApi	DeleteEmployerFromResumeVisibilityList	Delete /resumes/{resume_id}/{list_type}/employer	Удаление работодателя из списка видимости
DefaultApi	DeleteEmployerManager	Delete /employers/{employer_id}/managers/{manager_id}	Удаление менеджера
DefaultApi	DeleteResume	Delete /resumes/{resume_id}	Удаление резюме
DefaultApi	DeleteResumeVisibilityList	Delete /resumes/{resume_id}/{list_type}	Очистка списка видимости
DefaultApi	DeleteSavedResumeSearch	Delete /saved_searches/resumes/{id}	Удаление сохраненного поиска резюме
DefaultApi	DeleteSavedVacancySearch	Delete /saved_searches/vacancies/{id}	Удаление сохраненного поиска вакансий
DefaultApi	DeleteVacancyDraft	Delete /vacancies/drafts/{draft_id}	Удаление черновика вакансии
DefaultApi	DeleteVacancyFromBlacklisted	Delete /vacancies/blacklisted/{vacancy_id}	Удаление вакансии из списка скрытых
DefaultApi	DeleteVacancyFromFavorite	Delete /vacancies/favorited/{vacancy_id}	Удаление вакансии из списка отобранных
DefaultApi	DisableAutomaticVacancyPublication	Delete /vacancies/auto_publication	Отмена автопубликации вакансии
DefaultApi	EditArtifact	Put /artifacts/{id}	Редактирование артефакта
DefaultApi	EditCurrentUserInfo	Post /me	Редактирование информации авторизованного пользователя
DefaultApi	EditEmployerManager	Put /employers/{employer_id}/managers/{manager_id}	Редактирование менеджера
DefaultApi	EditNegotiationMessage	Put /negotiations/{nid}/messages/{mid}	Редактирование сообщения в отклике
DefaultApi	EditResume	Put /resumes/{resume_id}	Обновление резюме
DefaultApi	EditVacancy	Put /vacancies/{vacancy_id}	Редактирование вакансий
DefaultApi	EditVacancy_0	Put /vacancies/{vacancy_id}	Редактирование вакансий
DefaultApi	GetActiveNegotiations	Get /negotiations/active	Список активных откликов
DefaultApi	GetActiveVacancyList	Get /employers/{employer_id}/vacancies/active	Просмотр списка опубликованных вакансий
DefaultApi	GetActiveVacancyList_0	Get /employers/{employer_id}/vacancies/active	Просмотр списка опубликованных вакансий
DefaultApi	GetAddress	Get /employers/{employer_id}/addresses/{address_id}	Получение адреса
DefaultApi	GetAddress_0	Get /employers/{employer_id}/addresses/{address_id}	Получение адреса
DefaultApi	GetAllDistricts	Get /districts	Список районов во всех городах
DefaultApi	GetApplicantCommentsList	Get /applicant_comments/{applicant_id}	Получение списка комментариев
DefaultApi	GetApplicantCommentsList_0	Get /applicant_comments/{applicant_id}	Получение списка комментариев
DefaultApi	GetApplicantPhoneInfo	Get /resume_should_send_sms	Получить информацию о телефоне соискателя
DefaultApi	GetArchivedVacancies	Get /employers/{employer_id}/vacancies/archived	Список архивных вакансий
DefaultApi	GetArchivedVacancies_0	Get /employers/{employer_id}/vacancies/archived	Список архивных вакансий
DefaultApi	GetAreaLeavesSuggests	Get /suggests/area_leaves	Подсказки по регионам, являющимися листами в дереве регионов
DefaultApi	GetAreas	Get /areas	Дерево всех регионов
DefaultApi	GetAreasFromSpecified	Get /areas/{area_id}	Справочник регионов, начиная с указанного
DefaultApi	GetAreasSuggests	Get /suggests/areas	Подсказки по регионам
DefaultApi	GetArtifactPhotos	Get /artifacts/photo	Получение фотографий
DefaultApi	GetArtifactPhotosConditions	Get /artifacts/photo/conditions	Условия загрузки фотографий
DefaultApi	GetArtifactsPortfolio	Get /artifacts/portfolio	Получение портфолио
DefaultApi	GetArtifactsPortfolioConditions	Get /artifacts/portfolio/conditions	Условия загрузки портфолио
DefaultApi	GetAvailableVacancyTypes	Get /employers/{employer_id}/managers/{manager_id}/vacancies/available_types	Варианты публикации вакансий у текущего менеджера
DefaultApi	GetBlacklistedEmployers	Get /employers/blacklisted	Список скрытых работодателей
DefaultApi	GetBlacklistedVacancies	Get /vacancies/blacklisted	Список скрытых вакансий
DefaultApi	GetCollectionNegotiationsList	Get /negotiations/response	Список откликов/приглашений коллекции
DefaultApi	GetCollectionNegotiationsList_0	Get /negotiations/response	Список откликов/приглашений коллекции
DefaultApi	GetCountries	Get /areas/countries	Справочник стран
DefaultApi	GetCurrentUserInfo	Get /me	Информация о текущем пользователе
DefaultApi	GetCurrentUserInfo_0	Get /me	Информация о текущем пользователе
DefaultApi	GetCurrentUserInfo_1	Get /me	Информация о текущем пользователе
DefaultApi	GetCurrentUserInfo_2	Get /me	Информация о текущем пользователе
DefaultApi	GetCurrentUserInfo_3	Get /me	Информация о текущем пользователе
DefaultApi	GetDictionaries	Get /dictionaries	Справочники полей
DefaultApi	GetEducationalInstitutionsDictionary	Get /educational_institutions	Основная информация об учебных заведениях
DefaultApi	GetEducationalInstitutionsSuggests	Get /suggests/educational_institutions	Подсказки по названиям учебных заведений
DefaultApi	GetEmployerAddresses	Get /employers/{employer_id}/addresses	Список адресов работодателя
DefaultApi	GetEmployerAddresses_0	Get /employers/{employer_id}/addresses	Список адресов работодателя
DefaultApi	GetEmployerDepartments	Get /employers/{employer_id}/departments	Справочник департаментов работодателя
DefaultApi	GetEmployerDepartments_0	Get /employers/{employer_id}/departments	Справочник департаментов работодателя
DefaultApi	GetEmployerInfo	Get /employers/{employer_id}	Информация о работодателе
DefaultApi	GetEmployerManager	Get /employers/{employer_id}/managers/{manager_id}	Получение информации о менеджере
DefaultApi	GetEmployerManagerLimits	Get /employers/{employer_id}/managers/{manager_id}/limits/resume	Дневной лимит просмотра резюме для текущего менеджера
DefaultApi	GetEmployerManagerTypes	Get /employers/{employer_id}/manager_types	Справочник типов и прав менеджера
DefaultApi	GetEmployerManagerTypes_0	Get /employers/{employer_id}/manager_types	Справочник типов и прав менеджера
DefaultApi	GetEmployerManager_0	Get /employers/{employer_id}/managers/{manager_id}	Получение информации о менеджере
DefaultApi	GetEmployerManagers	Get /employers/{employer_id}/managers	Список менеджеров работодателя
DefaultApi	GetEmployerManagers_0	Get /employers/{employer_id}/managers	Список менеджеров работодателя
DefaultApi	GetEmployerVacancyAreas	Get /employers/{employer_id}/vacancy_areas/active	Список регионов, в которых есть активные вакансии
DefaultApi	GetFaculties	Get /educational_institutions/{id}/faculties	Список факультетов учебного заведения
DefaultApi	GetFavoriteVacancies	Get /vacancies/favorited	Список отобранных вакансий
DefaultApi	GetFieldsOfStudySuggestions	Get /suggests/fields_of_study	Подсказки по специализациям
DefaultApi	GetHiddenVacancies	Get /employers/{employer_id}/vacancies/hidden	Список удаленных вакансий
DefaultApi	GetHiddenVacancies_0	Get /employers/{employer_id}/vacancies/hidden	Список удаленных вакансий
DefaultApi	GetIndustries	Get /industries	Отрасли компаний
DefaultApi	GetLanguages	Get /languages	Список всех языков
DefaultApi	GetLocales	Get /locales	Список доступных локалей
DefaultApi	GetLocalesForResume	Get /locales/resume	Список доступных локалей для резюме
DefaultApi	GetMailTemplates	Get /employers/{employer_id}/mail_templates	Список доступных шаблонов ответов соискателю
DefaultApi	GetMailTemplates_0	Get /employers/{employer_id}/mail_templates	Список доступных шаблонов ответов соискателю
DefaultApi	GetManagerAccounts	Get /manager_accounts/mine	Рабочие аккаунты менеджера
DefaultApi	GetManagerSettings	Get /employers/{employer_id}/managers/{manager_id}/settings	Предпочтения менеджера
DefaultApi	GetMetroStations	Get /metro	Список станций метро во всех городах
DefaultApi	GetMetroStationsInCity	Get /metro/{city_id}	Список станций метро в указанном городе
DefaultApi	GetMineResumes	Get /resumes/mine	Список резюме авторизованного пользователя
DefaultApi	GetNegotiationItem	Get /negotiations/{id}	Просмотр отклика/приглашения
DefaultApi	GetNegotiationItem_0	Get /negotiations/{id}	Просмотр отклика/приглашения
DefaultApi	GetNegotiationMessageTemplates	Get /message_templates/{template}	Список шаблонов ответов для отклика/приглашения
DefaultApi	GetNegotiationMessages	Get /negotiations/{nid}/messages	Просмотр списка сообщений в отклике/приглашении
DefaultApi	GetNegotiationMessages_0	Get /negotiations/{nid}/messages	Просмотр списка сообщений в отклике/приглашении
DefaultApi	GetNegotiationMessages_1	Get /negotiations/{nid}/messages	Просмотр списка сообщений в отклике/приглашении
DefaultApi	GetNegotiationTestResults	Get /negotiations/{nid}/test/solution	Получить результаты тестов, прикрепленных к вакансии
DefaultApi	GetNegotiationTestResults_0	Get /negotiations/{nid}/test/solution	Получить результаты тестов, прикрепленных к вакансии
DefaultApi	GetNegotiations	Get /negotiations	Список откликов/приглашений
DefaultApi	GetNegotiationsStatisticsEmployer	Get /employers/{employer_id}/negotiations_statistics	Статистика откликов для компании
DefaultApi	GetNegotiationsStatisticsEmployer_0	Get /employers/{employer_id}/negotiations_statistics	Статистика откликов для компании
DefaultApi	GetNegotiationsStatisticsManager	Get /employers/{employer_id}/managers/{manager_id}/negotiations_statistics	Статистика откликов для менеджера
DefaultApi	GetNegotiationsStatisticsManager_0	Get /employers/{employer_id}/managers/{manager_id}/negotiations_statistics	Статистика откликов для менеджера
DefaultApi	GetNegotiations_0	Get /negotiations	Список откликов/приглашений
DefaultApi	GetNegotiations_1	Get /negotiations	Список откликов/приглашений
DefaultApi	GetNewResumeConditions	Get /resume_conditions	Условия заполнения полей нового резюме
DefaultApi	GetPayableApiActions	Get /employers/{employer_id}/services/payable_api_actions/active	Информация по активным услугам API для платных методов
DefaultApi	GetPayableApiMethodAccess	Get /employers/{employer_id}/managers/{manager_id}/method_access	Проверка доступа к платным методам
DefaultApi	GetPositionsSuggestions	Get /suggests/positions	Подсказки по должностям резюме
DefaultApi	GetPrefNegotiationsOrder	Get /vacancies/{id}/preferred_negotiations_order	Просмотр предпочитаемой сортировки откликов
DefaultApi	GetPrefNegotiationsOrder_0	Get /vacancies/{id}/preferred_negotiations_order	Просмотр предпочитаемой сортировки откликов
DefaultApi	GetProfessionalRolesDictionary	Get /professional_roles	Справочник профессиональных ролей
DefaultApi	GetProfessionalRolesSuggests	Get /suggests/professional_roles	Подсказки по профессиональным ролям
DefaultApi	GetProlongationVacancyInfo	Get /vacancies/{vacancy_id}/prolongate	Информация о возможности продления вакансии
DefaultApi	GetProlongationVacancyInfo_0	Get /vacancies/{vacancy_id}/prolongate	Информация о возможности продления вакансии
DefaultApi	GetRegisteredCompaniesSuggests	Get /suggests/companies	Подсказки по зарегистрированным организациям
DefaultApi	GetResume	Get /resumes/{resume_id}	Просмотр резюме
DefaultApi	GetResumeAccessTypes	Get /resumes/{resume_id}/access_types	Получение списка типов видимости резюме
DefaultApi	GetResumeConditions	Get /resumes/{resume_id}/conditions	Условия заполнения полей существующего резюме
DefaultApi	GetResumeCreationAvailability	Get /resumes/creation_availability	Проверка возможности создания резюме
DefaultApi	GetResumeNegotiationsHistory	Get /resumes/{resume_id}/negotiations_history	История откликов/приглашений по резюме
DefaultApi	GetResumeNegotiationsHistory_0	Get /resumes/{resume_id}/negotiations_history	История откликов/приглашений по резюме
DefaultApi	GetResumeSearchKeywordsSuggests	Get /suggests/resume_search_keyword	Подсказки по ключевым словам поиска резюме
DefaultApi	GetResumeStatus	Get /resumes/{resume_id}/status	Статус резюме и готовность к публикации
DefaultApi	GetResumeViewHistory	Get /resumes/{resume_id}/views	История просмотра резюме
DefaultApi	GetResumeVisibilityEmployersList	Get /resumes/{resume_id}/{list_type}/search	Поиск работодателей для добавления в список видимости
DefaultApi	GetResumeVisibilityList	Get /resumes/{resume_id}/{list_type}	Получение списка видимости резюме
DefaultApi	GetResume_0	Get /resumes/{resume_id}	Просмотр резюме
DefaultApi	GetResume_1	Get /resumes/{resume_id}	Просмотр резюме
DefaultApi	GetResume_2	Get /resumes/{resume_id}	Просмотр резюме
DefaultApi	GetResumesByStatus	Get /vacancies/{vacancy_id}/resumes_by_status	Резюме, сгруппированные по возможности отклика на данную вакансию
DefaultApi	GetSalaryEmployeeLevels	Get /salary_statistics/dictionaries/employee_levels	Уровни компетенций
DefaultApi	GetSalaryEvaluation	Get /salary_statistics/paid/salary_evaluation/{area_id}	Оценка заработной платы без прогноза
DefaultApi	GetSalaryEvaluation_0	Get /salary_statistics/paid/salary_evaluation/{area_id}	Оценка заработной платы без прогноза
DefaultApi	GetSalaryIndustries	Get /salary_statistics/dictionaries/salary_industries	Отрасли и сферы деятельности
DefaultApi	GetSalaryProfessionalAreas	Get /salary_statistics/dictionaries/professional_areas	Профобласти и специализации
DefaultApi	GetSalarySalaryAreas	Get /salary_statistics/dictionaries/salary_areas	Регионы и города
DefaultApi	GetSavedResumeSearch	Get /saved_searches/resumes/{id}	Получение единичного сохраненного поиска резюме
DefaultApi	GetSavedResumeSearches	Get /saved_searches/resumes	Список сохраненных поисков резюме
DefaultApi	GetSavedVacancySearch	Get /saved_searches/vacancies/{id}	Получение единичного сохраненного поиска вакансий
DefaultApi	GetSavedVacancySearches	Get /saved_searches/vacancies	Список сохраненных поисков вакансий
DefaultApi	GetSkillSetSuggests	Get /suggests/skill_set	Подсказки по ключевым навыкам
DefaultApi	GetSkills	Get /skills	Справочник ключевых навыков
DefaultApi	GetSuitableResumes	Get /vacancies/{vacancy_id}/suitable_resumes	Список подходящих для отклика резюме
DefaultApi	GetTestsDictionary	Get /employers/{employer_id}/tests	Справочник тестов работодателя
DefaultApi	GetTestsDictionary_0	Get /employers/{employer_id}/tests	Справочник тестов работодателя
DefaultApi	GetVacancies	Get /vacancies	Поиск по вакансиям
DefaultApi	GetVacanciesRelatedToVacancy	Get /vacancies/{vacancy_id}/related_vacancies	Поиск подходящих вакансий
DefaultApi	GetVacanciesSimilarToResume	Get /resumes/{resume_id}/similar_vacancies	Поиск по вакансиям, похожим на резюме
DefaultApi	GetVacanciesSimilarToVacancy	Get /vacancies/{vacancy_id}/similar_vacancies	Поиск по вакансиям, похожим на вакансию
DefaultApi	GetVacancy	Get /vacancies/{vacancy_id}	Просмотр вакансии
DefaultApi	GetVacancyBrandedTemplatesList	Get /employers/{employer_id}/vacancy_branded_templates	Список доступных бренд шаблонов вакансий работодателя
DefaultApi	GetVacancyBrandedTemplatesList_0	Get /employers/{employer_id}/vacancy_branded_templates	Список доступных бренд шаблонов вакансий работодателя
DefaultApi	GetVacancyConditions	Get /vacancy_conditions	Условия заполнения полей при добавлении и редактировании вакансий
DefaultApi	GetVacancyDraft	Get /vacancies/drafts/{draft_id}	Получение черновика вакансии
DefaultApi	GetVacancyDraftList	Get /vacancies/drafts	Получение списка черновиков вакансий
DefaultApi	GetVacancyPositionsSuggests	Get /suggests/vacancy_positions	Подсказки по должностям вакансий
DefaultApi	GetVacancySearchKeywords	Get /suggests/vacancy_search_keyword	Подсказки по ключевым словам поиска вакансий
DefaultApi	GetVacancyStats	Get /vacancies/{vacancy_id}/stats	Статистика по вакансии
DefaultApi	GetVacancyUpgradeList	Get /vacancies/{vacancy_id}/upgrades	Список улучшений для вакансии
DefaultApi	GetVacancyVisitors	Get /vacancies/{vacancy_id}/visitors	Посмотревшие вакансию
DefaultApi	GetVacancy_0	Get /vacancies/{vacancy_id}	Просмотр вакансии
DefaultApi	HideActiveResponse	Delete /negotiations/active/{nid}	Скрыть отклик
DefaultApi	InvalidateToken	Delete /oauth/token	Инвалидация токена
DefaultApi	InvalidateToken_0	Delete /oauth/token	Инвалидация токена
DefaultApi	InvalidateToken_1	Delete /oauth/token	Инвалидация токена
DefaultApi	InviteApplicantToVacancy	Post /negotiations/phone_interview	Пригласить соискателя на вакансию
DefaultApi	InviteApplicantToVacancy_0	Post /negotiations/phone_interview	Пригласить соискателя на вакансию
DefaultApi	LoadArtifact	Post /artifacts	Загрузка артефакта
DefaultApi	MoveSavedResumeSearch	Put /saved_searches/resumes/{saved_search_id}/managers/{manager_id}	Передача сохраненного поиска резюме другому менеджеру
DefaultApi	PostNegotiationsTopicsRead	Post /negotiations/read	Отметить отклики прочитанными
DefaultApi	PostNegotiationsTopicsRead_0	Post /negotiations/read	Отметить отклики прочитанными
DefaultApi	PublishResume	Post /resumes/{resume_id}/publish	Публикация резюме
DefaultApi	PublishVacancy	Post /vacancies	Публикация вакансии
DefaultApi	PublishVacancyFromDraft	Post /vacancies/drafts/{draft_id}/publish	Публикация вакансии на основе черновика
DefaultApi	PublishVacancy_0	Post /vacancies	Публикация вакансии
DefaultApi	PutMailTemplatesItem	Put /employers/{employer_id}/mail_templates/{template_id}	Изменение шаблона ответа соискателю
DefaultApi	PutMailTemplatesItem_0	Put /employers/{employer_id}/mail_templates/{template_id}	Изменение шаблона ответа соискателю
DefaultApi	PutNegotiationsCollectionToNextState	Put /negotiations/{id}	Действия по откликам/приглашениям
DefaultApi	PutNegotiationsCollectionToNextState_0	Put /negotiations/{id}	Действия по откликам/приглашениям
DefaultApi	PutPrefNegotiationsOrder	Put /vacancies/{id}/preferred_negotiations_order	Изменение предпочитаемой сортировки откликов
DefaultApi	PutPrefNegotiationsOrder_0	Put /vacancies/{id}/preferred_negotiations_order	Изменение предпочитаемой сортировки откликов
DefaultApi	RestoreVacancyFromHidden	Delete /employers/{employer_id}/vacancies/hidden/{vacancy_id}	Восстановление вакансии из удаленных
DefaultApi	SearchEmployer	Get /employers	Поиск работодателя
DefaultApi	SearchForResumes	Get /resumes	Поиск резюме
DefaultApi	SearchForResumes_0	Get /resumes	Поиск резюме
DefaultApi	SearchForVacancyDraftDuplicates	Get /vacancies/drafts/{draft_id}/duplicates	Проверка наличия дубликатов вакансии
DefaultApi	SendCodeForVerifyPhoneInResume	Post /resume_phone_generate_code	Отправить код подтверждения для телефона резюме
DefaultApi	SendNegotiationMessage	Post /negotiations/{nid}/messages	Отправка нового сообщения
DefaultApi	SendNegotiationMessage_0	Post /negotiations/{nid}/messages	Отправка нового сообщения
DefaultApi	UpdateApplicantComment	Put /applicant_comments/{applicant_id}/{comment_id}	Обновление комментария
DefaultApi	UpdateApplicantComment_0	Put /applicant_comments/{applicant_id}/{comment_id}	Обновление комментария
DefaultApi	UpdateSavedResumeSearch	Put /saved_searches/resumes/{id}	Обновление сохраненного поиска резюме
DefaultApi	UpdateSavedVacancySearch	Put /saved_searches/vacancies/{id}	Обновление сохраненного поиска вакансий
DefaultApi	VacancyProlongation	Post /vacancies/{vacancy_id}/prolongate	Продление вакансии
DefaultApi	VacancyProlongation_0	Post /vacancies/{vacancy_id}/prolongate	Продление вакансии
WebhookAPIAPI	CancelWebhookSubscription	Delete /webhook/subscriptions/{subscription_id}	Удалить подписку на уведомление
WebhookAPIAPI	ChangeWebhookSubscription	Put /webhook/subscriptions/{subscription_id}	Изменить подписку на уведомления
WebhookAPIAPI	GetWebhookSubscriptions	Get /webhook/subscriptions	Получить список уведомлений, на которые подписан пользователь
WebhookAPIAPI	PostWebhookSubscription	Post /webhook/subscriptions	Подписаться на уведомления

Documentation For Models

Documentation For Authorization

Authentication schemes defined for the API:

OauthToken

Type: HTTP Bearer token authentication

Example

auth := context.WithValue(context.Background(), hh.ContextAccessToken, "BEARER_TOKEN_STRING")
r, err := client.Service.Operation(auth, args)

Documentation for Utility Methods

Due to the fact that model structure members are all pointers, this package contains a number of utility functions to easily obtain pointers to values of basic types. Each of these functions takes a value of the given basic type and returns a pointer to it:

PtrBool
PtrInt
PtrInt32
PtrInt64
PtrFloat
PtrFloat32
PtrFloat64
PtrString
PtrTime

Author

api@hh.ru

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

Go API client for hh

Общая информация

Требования к запросам

Формат тела запроса при отправке JSON

Ответ

Ошибки и коды ответов

Недокументированные поля и параметры запросов

Пагинация

Выбор сайта

CORS (Cross-Origin Resource Sharing)

Внешние ссылки на статьи и стандарты

Авторизация

Авторизация пользователя

Правила формирования специального redirect_uri

Процесс авторизации

Успешное получение временного `authorization_code`

Получение access и refresh токенов

Обновление пары access и refresh токенов

Запрос авторизации под другим пользователем

Авторизация под разными рабочими аккаунтами

Overview

Installation

Configuration of Server URL

Select Server Configuration

Templated Server URL

URLs Configuration per Operation

Documentation for API Endpoints

Documentation For Models

Documentation For Authorization

OauthToken

Documentation for Utility Methods

Author

About

Contributors 2

Languages

Name		Name	Last commit message	Last commit date
Latest commit History 60 Commits
.github/workflows		.github/workflows
.openapi-generator		.openapi-generator
api		api
docs		docs
.gitignore		.gitignore
.openapi-generator-ignore		.openapi-generator-ignore
.travis.yml		.travis.yml
README.md		README.md
api_.go		api_.go
api_webhook_api.go		api_webhook_api.go
client.go		client.go
configuration.go		configuration.go
git_push.sh		git_push.sh
go.mod		go.mod
go.sum		go.sum
model__includes_area.go		model__includes_area.go
model__includes_cluster_metro_line.go		model__includes_cluster_metro_line.go
model__includes_cluster_metro_line_area.go		model__includes_cluster_metro_line_area.go
model__includes_cluster_metro_station.go		model__includes_cluster_metro_station.go
model__includes_cluster_metro_station_area.go		model__includes_cluster_metro_station_area.go
model__includes_contact.go		model__includes_contact.go
model__includes_contact_phone_value.go		model__includes_contact_phone_value.go
model__includes_contact_properties.go		model__includes_contact_properties.go
model__includes_contact_properties_value.go		model__includes_contact_properties_value.go
model__includes_count_url.go		model__includes_count_url.go
model__includes_educational_institution_item.go		model__includes_educational_institution_item.go
model__includes_educational_institution_item_area.go		model__includes_educational_institution_item_area.go
model__includes_employer_applicant_services.go		model__includes_employer_applicant_services.go
model__includes_employer_applicant_services_object.go		model__includes_employer_applicant_services_object.go
model__includes_employer_applicant_services_target_employer.go		model__includes_employer_applicant_services_target_employer.go
model__includes_id.go		model__includes_id.go
model__includes_id_name.go		model__includes_id_name.go
model__includes_id_name_desc.go		model__includes_id_name_desc.go
model__includes_id_name_last_change_time.go		model__includes_id_name_last_change_time.go
model__includes_id_name_uid.go		model__includes_id_name_uid.go
model__includes_id_name_url.go		model__includes_id_name_url.go
model__includes_language_level.go		model__includes_language_level.go
model__includes_language_properties.go		model__includes_language_properties.go
model__includes_language_properties_all_of_level.go		model__includes_language_properties_all_of_level.go
model__includes_logo_urls.go		model__includes_logo_urls.go
model__includes_logo_urls90.go		model__includes_logo_urls90.go
model__includes_metro_station.go		model__includes_metro_station.go
model__includes_name.go		model__includes_name.go
model__includes_name_description.go		model__includes_name_description.go
model__includes_nullable_object.go		model__includes_nullable_object.go
model__includes_numeric_id.go		model__includes_numeric_id.go
model__includes_pagination.go		model__includes_pagination.go
model__includes_skill_set_item.go		model__includes_skill_set_item.go
model__includes_sorting_type.go		model__includes_sorting_type.go
model__includes_url.go		model__includes_url.go
model__webhook_subscriptions_post_request.go		model__webhook_subscriptions_post_request.go
model_applicant_comments_access_type.go		model_applicant_comments_access_type.go
model_applicant_comments_applicant_comment_item.go		model_applicant_comments_applicant_comment_item.go
model_applicant_comments_applicant_comment_item_access_type.go		model_applicant_comments_applicant_comment_item_access_type.go
model_applicant_comments_applicant_comment_item_author.go		model_applicant_comments_applicant_comment_item_author.go
model_applicant_comments_applicant_comment_items.go		model_applicant_comments_applicant_comment_items.go
model_applicant_comments_applicant_comments_list.go		model_applicant_comments_applicant_comments_list.go
model_applicant_comments_author.go		model_applicant_comments_author.go
model_apply_to_vacancy_400_response.go		model_apply_to_vacancy_400_response.go
model_artifacts_artifact_conditions.go		model_artifacts_artifact_conditions.go
model_artifacts_artifact_conditions_counters.go		model_artifacts_artifact_conditions_counters.go
model_artifacts_artifact_conditions_fields.go		model_artifacts_artifact_conditions_fields.go
model_artifacts_artifact_item.go		model_artifacts_artifact_item.go
model_artifacts_artifact_photo_items.go		model_artifacts_artifact_photo_items.go
model_artifacts_artifact_photo_response.go		model_artifacts_artifact_photo_response.go
model_artifacts_artifact_portfolio_item.go		model_artifacts_artifact_portfolio_item.go
model_artifacts_artifact_portfolio_items.go		model_artifacts_artifact_portfolio_items.go
model_artifacts_artifact_portfolio_response.go		model_artifacts_artifact_portfolio_response.go
model_artifacts_counters.go		model_artifacts_counters.go
model_artifacts_description.go		model_artifacts_description.go
model_artifacts_fields.go		model_artifacts_fields.go
model_artifacts_fields_description.go		model_artifacts_fields_description.go
model_artifacts_fields_file.go		model_artifacts_fields_file.go
model_artifacts_fields_type.go		model_artifacts_fields_type.go
model_artifacts_file.go		model_artifacts_file.go
model_artifacts_portfolio_description.go		model_artifacts_portfolio_description.go
model_artifacts_state.go		model_artifacts_state.go
model_artifacts_type.go		model_artifacts_type.go
model_auth_app_token.go		model_auth_app_token.go
model_auth_user_token.go		model_auth_user_token.go
model_auth_user_token_and_app_token.go		model_auth_user_token_and_app_token.go
model_create_resume_400_response.go		model_create_resume_400_response.go
model_creds_answers.go		model_creds_answers.go
model_creds_creds.go		model_creds_creds.go
model_creds_questions.go		model_creds_questions.go
model_dictionaries_area_item.go		model_dictionaries_area_item.go
model_dictionaries_branch_item.go		model_dictionaries_branch_item.go
model_dictionaries_currency_item.go		model_dictionaries_currency_item.go
model_dictionaries_dict_response.go		model_dictionaries_dict_response.go
model_dictionaries_district_item.go		model_dictionaries_district_item.go
model_dictionaries_lang_item.go		model_dictionaries_lang_item.go
model_dictionaries_salary_statistics_area_item.go		model_dictionaries_salary_statistics_area_item.go
model_dictionaries_salary_statistics_professional_areas_response_inner.go		model_dictionaries_salary_statistics_professional_areas_response_inner.go
model_dictionaries_salary_statistics_specializations.go		model_dictionaries_salary_statistics_specializations.go
model_dictionaries_skills_response.go		model_dictionaries_skills_response.go
model_districts_district_item.go		model_districts_district_item.go
model_edit_vacancy_400_response.go		model_edit_vacancy_400_response.go
model_employer_addresses_employer_address_item.go		model_employer_addresses_employer_address_item.go
model_employer_addresses_employer_address_item_manager.go		model_employer_addresses_employer_address_item_manager.go
model_employer_addresses_employer_address_item_response.go		model_employer_addresses_employer_address_item_response.go

zaboal/go_hh

Folders and files

Latest commit

History

Repository files navigation

Go API client for hh

Общая информация

Требования к запросам

Формат тела запроса при отправке JSON

Ответ

Ошибки и коды ответов

Недокументированные поля и параметры запросов

Пагинация

Выбор сайта

CORS (Cross-Origin Resource Sharing)

Внешние ссылки на статьи и стандарты

Авторизация

Авторизация пользователя

Правила формирования специального redirect_uri

Процесс авторизации

Успешное получение временного authorization_code

Получение access и refresh токенов

Обновление пары access и refresh токенов

Запрос авторизации под другим пользователем

Авторизация под разными рабочими аккаунтами

Overview

Installation

Configuration of Server URL

Select Server Configuration

Templated Server URL

URLs Configuration per Operation

Documentation for API Endpoints

Documentation For Models

Documentation For Authorization

OauthToken

Documentation for Utility Methods

Author

About

Topics

Resources

Code of conduct

Stars

Watchers

Forks

Contributors 2

Languages

Успешное получение временного `authorization_code`