authorization.md

Авторизация

Для выполнения большинства запросов к API необходимо передавать access-токен. Авторизация осуществляется по протоколу OAuth 2.0.

Зарегистрированное приложение может запрашивать у пользователей hh.ru разрешение доступа к их персональным данным, без получения и хранения их логина и пароля.

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

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

---

До 1 апреля 2015 года основной домен API был m.hh.ru. Авторизация через m.hh.ru будет доступна, однако теперь рекомендуется использовать домен hh.ru. Документация была обновлена в соответствии с новым адресом.

---

• Получение access-токена
• Использование access-токена
• Проверка access-токена
• Полезные ссылки

Получение access-токена

• Получение токена приложения
• Получение токена пользователя

Использование access-токена

Приложение должно использовать полученный access_token для авторизации, передавая его в заголовке в формате:

Authorization: Bearer ACCESS_TOKEN

Описание ошибок авторизации.

Проверка access-токена

Для тестирования токена удобно использовать метод /me

Пример запроса:

GET /me HTTP/1.1
User-Agent: MyApp/1.0 ([email protected])
Host: api.hh.ru
Accept: */*
Authorization: Bearer access_token

Более подробное описание метода /me в соответствующих разделах:

• для авторизованного приложения
• для авторизованного пользователя

Полезные ссылки

• Подробная документация по протоколу: RFC 6749
• Библиотека ScribeJava, поддерживающая авторизацию в API HeadHunter.
  • Habrahabr: ScribeJava — даже ваша бабушка сможет работать с OAuth