API hh.ru. Быстрый старт / Хабр
Полагаю, некоторые из вас знают, что у hh.ru есть открытый API (мы рассказывали о нем тут и тут), который используем не только мы, но и сторонние разработчики. С его помощью, например, можно очень детально анализировать рынок на больших объемах актуальных данных.
Я задумал серию из двух статей: в этой покажу, как можно быстро и просто начать использовать API, а в следующей сделаю небольшой проект, рекомендующий актуальные вакансии по вашему резюме.
Сначала вкратце о том, что вообще есть в нашем API, где и как его используют.
Чтобы быстро получить представление о возможностях API, обратите внимание, например, на наши мобильные приложения для соискателя (Android, iOS) и работодателя (Android, iOS). Они работают через API.
Например, внешние разработчики могут получить все актуальные и архивные вакансии с зарплатами и остальными деталями. А это почти 400 тыс.
Через API работает поиск по вакансиям. Доступны различные справочники: регионы, используемые на сайте, специализации работников, отрасли компаний, станции метро и прочее. Для авторизованных пользователей доступна работа с вашими вакансиями или резюме: в зависимости от того, работодатель вы или соискатель. Для работодателей есть поиск по вакансиям и возможность работы с ними.
За более детальной информацией обращайтесь к нашей документации.
Всё взаимодействие происходит про протоколу HTTPS в лучших традициях REST. Получаем что-то — делаем GET-запрос, удаляем — DELETE, создаем — POST, редактируем — PUT. Обмен данными производится в формате JSON. Некоторые операции доступны без авторизации, другие — нет. Авторизованный пользователь может выступать в роли работодателя или соискателя. От этого зависит, какие методы ему доступны.
Для того чтобы начать работать с данными, доступными без авторизации, вам ничего не потребуется. Смотрим в документации, какие методы можно использовать, делаем запрос — получаем данные. Например, если хочется посмотреть вакансии
curl -k -H 'User-Agent: api-test-agent' 'https://api.hh.ru/vacancies'
Следует обратить внимание, что нужно передавать заголовок User-Agent. Без него работать не будет.
Для поиска вакансий можно задавать разные параметры.
Так, например, можно поискать вакансию по ключевому слову Java в Москве у станции метро «Алексеевская»
curl -k -H 'User-Agent: api-test-agent' 'https://api.hh.ru/vacancies?text=java&area=1&metro=6.8'
Значения area и metro можно получить из справочников.
Как уже было сказано, для авторизации используется протокол OAuth3.
Чтобы делать что-то из-под пользователя, для него требуется получить токен и передавать этот токен в заголовке при запросе. Для получения токена для своего пользователя достаточно его сгенерировать в интерфейсе API. Заходим в личный кабинет на https://dev.hh.ru и нажимаем на кнопку «Сгенерировать токен».
Чтобы остальные пользователи могли выполнять действия в вашем приложении, это приложение необходимо сначала завести в личном кабинете. Добавляем приложение, указав redirect URI. На этот адрес пользователь будет автоматически возвращаться после авторизации.
После добавления приложения, ему будут присвоены Client ID и Client Secret.
Как работает авторизация?
В своем приложении вы размещаете ссылку на авторизацию, указывая в ней Client ID приложения, например,
https://hh.ru/oauth/authorize?response_type=code&client_id=LOTHHN3BSET0I7IQNF3N5I0362AE1D14I6M74CAIQ5h59F7MT4PLMTVV7JTOA6QA
Когда пользователь переходит по этой ссылке, для него на нашей стороне генерируется специальный код.
И наш сайт перенаправляет пользователя обратно в ваше приложение (по redirect URI, который был указан при регистрации приложения), добавив к адресу вашего приложения параметр, содержащий код. Например:
http://yourapphost/?code=J2CO4TM7PK58NNVFCJSLPMML15IKQERD5CT2L8VGK82Q333ILAKQ28BPURIO1LG8
После этого вы вытаскиваете из этого адреса code и используете его для получения токена, сделав POST-запрос в API, передав code, client_id и client_secret.
curl -k -X POST -H 'User-Agent: api-test-agent' -d 'grant_type=authorization_code&client_id=LOTHHN3BSET0I7IQNF3N5I0362AE1D14I6M74CAIQ5h59F7MT4PLMTVV7JTOA6QA&client_secret=JS33UVG3J6JANNEATPND57BME23BKDCPP2Uh2NB0C21HUMNGS5T71AVP6P24E0EI&code=J2CO4TM7PK58NNVFCJSLPMML15IKQERD5CT2L8VGK82Q333ILAKQ28BPURIO1LG8' https://hh.ru/oauth/token
В ответ вы получите json, содержащий токен (поле access_token):
{
"access_token": "VTEJ4PDD8R4MHEO7LTQM6RLEGJ1O8B1F79TGF45LIDQD11K50HMMBETB47BBCMQ1",
"token_type": "bearer",
"expires_in": 1209599,
"refresh_token": "OARLQNLT6JSMDI88CO5QIP35OOSQUTOO9IQNT20MOMAHE4H8SGPM7LQUAP8EO1G6"
}
Это всё.
Вот, например, запрос для получения списка резюме текущего пользователя:
curl -k -H 'Authorization: Bearer VTEJ4PDD8R4MHEO7LTQM6RLEGJ1O8B1F79TGF45LIDQD11K50HMMBETB21BBCMQ1' -H 'User-Agent: api-test-agent' https://api.hh.ru/resumes/mine
Следует учесть, что у токена есть срок жизни, указанный в поле expires_in, после истечения которого токен надо обновить.
API постоянно растет, в нем реализуется всё больше новых возможностей. Если вам сильно не хватает какого-то функционала, есть пожелания или вы нашли ошибку, то напишите нам в issues на гитхабе.
hh.ru добавил новый способ регистрации работодателей с помощью Tinkoff ID — hh.ru на vc.ru
hh.ru
hh.ru добавил новый способ регистрации работодателей с помощью Tinkoff ID. Теперь все работодатели из малого бизнеса могут зарегистрироваться или пройти авторизацию на hh.ru с помощью Tinkoff ID без ввода пароля и логина всего в пару кликов.
121 просмотров
Интеграция Tinkoff ID с hh.ru кратно уменьшает количество действий для регистрации и входа на сервис. При регистрации на сайте hh.ru или в мобильном приложении hh бизнес через Tinkoff ID для компаний из малого бизнеса нет необходимости заполнять анкету и загружать документы, все данные вносятся автоматически, что существенно сокращает время процесса и снижает риски некорректного заполнения.
Опция доступна пользователям, в том числе и индивидуальным предпринимателям, у которых есть аккаунт в Тинькофф Бизнес.
Преимущества авторизации на hh.ru через Tinkoff ID — это
— быстрый вход, при котором не нужно вспоминать логин и пароль;
— защита данных — информация о работодателе надёжно защищена и предоставляется только с его согласия;
— экономия времени — анкета заполняется за работодателя, ему остаётся лишь проверить корректность данных, после чего он может сразу приступить к главной задаче — поиску персонала на hh.ru.
Авторизация по Tinkoff ID для юридических лиц доступна всем пользователям с личным кабинетом в Тинькофф Бизнесе. А подключить Tinkoff ID для юридических лиц себе на сайт или в приложение может любая компания, которая работает с бизнесом и индивидуальными предпринимателями, — для этого не нужно быть клиентом Тинькофф.
Наша интеграция с Tinkoff ID — это очередной важный шаг в упрощении использования hh.ru тысячам работодателей из малого бизнеса по всей стране. Теперь для пользователей Tinkoff ID мы можем исключить необходимые этапы ручного заполнения данных о том, что новый работодатель добросовестный и ведёт реальную бизнес-деятельность. Это позволит нам сохранить высокий уровень доверия со стороны соискателей как безопасной среды поиска работы, при этом существенно упростив для работодателей регистрацию и вход на сервис.
Юлия Колпакова, руководитель welcome-службы hh.ru
Вход по Tinkoff ID для юридических лиц — это закономерный и важный этап развития нашего продукта, и мы рады, что hh.ru стал одним из первых партнёров Тинькофф по этому направлению. Теперь и представители бизнеса смогут за пару кликов пройти авторизацию на сайте и оценить все преимущества Tinkoff ID, такие как скорость, удобство, и самое главное, надёжность и безопасность нашего сервиса.
Виталий Бриедис, руководитель сервиса Tinkoff ID
Контроль доступа и информация о воротах :: Объединенная база Майер-Хендерсон Холл
Круглосуточная поддержка
Круглосуточная поддержка
Круглосуточная поддержка
ЗАПРОС ДОСТУПА К JBM-HH
При запросе доступа к базе онлайн:
– Запрашивайте онлайн не более чем за 14 дней или менее чем за 3 дня до даты, когда требуется доступ.
– один адрес электронной почты может быть связан с одним активным запросом одновременно.
— Вы можете отправить запрос на пропуск с помощью Gmail; однако из-за расширенных настроек безопасности Gmail электронные письма
содержащие утвержденные пропуска, могут попасть в спам или быть полностью заблокированы.
— Если вы не получили ответ по электронной почте в течение 24–72 часов, проверьте папку со спамом.
– Активные запросы начинаются, когда вы вводите свою информацию в Интернете, и заканчиваются, когда истечет срок действия пропуска.
– В случае одобрения вы получите пропуск по электронной почте. НЕОБХОДИМО НАПЕЧАТАТЬ , когда вы придете на установку.
– Если вы не получили ответ по электронной почте в течение 24–72 часов, получили отказ или у вас возникли вопросы, позвоните в VCC в рабочее время по телефону 703-696-0186/0189 для получения помощи.
Запросите пропуск на 24-часовую базу, посетив: https://pass.aie.army.mil/jbmhh/
Часто задаваемые вопросы о совместном доступе к базе
Какое удостоверение личности нужно всегда иметь при себе при посещении совместной базы?
У вас должна быть одна форма разрешенного удостоверения личности с фотографией, например, государственные удостоверения личности/водительские права, паспорта, карты общего доступа, не относящиеся к Министерству обороны США, и грин-карты.
Все документы должны быть оригинальными – никаких копий или цифровых версий.
Закрывающая вкладка
Нужно ли несовершеннолетним запрашивать доступ к базе?
Несовершеннолетние в возрасте 17 лет и младше не нуждаются в почтовом доступе, однако они должны быть в сопровождении родителя, опекуна или посещать объект для разрешенных групповых мероприятий.
Закрывающая вкладка
Какие ворота я могу использовать как посетитель JBM-HH?
Посетители могут использовать только ворота Hatfield в кампусе Myer и 2 nd Street Gate в кампусе McNair.
Закрывающая вкладка
Что делать, если мне нужен пропуск на срок более одного дня?
Возьмите текущий действующий пропуск или обратитесь непосредственно в VCC в обычные часы работы, они могут вам помочь.
Убедитесь, что у вас есть одна форма разрешенного удостоверения личности с фотографией, такая как государственные удостоверения личности/водительские права, паспорта, карты общего доступа, не относящиеся к Министерству обороны США, и грин-карты. Все документы должны быть оригинальными – никаких копий или цифровых версий. У всех вас должна быть авторизованная причина для доступа к почте и/или авторизованный спонсор Министерства обороны США.
Закрывающая вкладка
Что делать, если у меня нет пропуска и мне нужно попасть на базу в нерабочее время?
Принесите одно официальное удостоверение личности с фотографией, например, оригиналы государственных удостоверений личности/водительских прав, паспортов, общих карт доступа, не относящихся к Министерству обороны США, и грин-карт, либо к воротам на улице 2 nd Street Gate (кампус McNair), либо к воротам Hatfield (Myer кампус), и вас направят на проверку в правоохранительных органах.
В случае одобрения вы получите 24-часовой пропуск доступа к почте.
Посетители могут сократить этот процесс, предварительно заполнив и распечатав форму запроса на доступ к установке. Каждый пассажир в транспортном средстве (18+) должен заполнить копию формы запроса. Ответьте на вопросы в разделе A: блоки 1-10a (продолжите, если вы не являетесь гражданином США) являются обязательными. Блок 11, отметьте участника мероприятия. Раздел С является обязательным.
Закрывающая вкладка
Что делать, если у меня есть активный базовый запрос на доступ, но мне нужен еще один или нужно расширить текущий?
Не отправлять еще один онлайн-запрос. Позвоните или зайдите в Центр управления посетителями в рабочее время.
Закрывающая вкладка
Каковы часы работы Центра контроля посетителей?
VCC в Hatfield Gate (кампус Myer) открыт с 6:00 до 17:00.
будние дни и с 10 до 15 часов. по субботам. Он закрыт по воскресеньям.
VCC по адресу 2 nd Street Gate (кампус McNair) работает с 8:00 до 16:00. в будни и закрыт по выходным.
Оба VCC закрыты в праздничные дни.
Закрывающая вкладка
Что, если у меня возникнут дополнительные вопросы относительно базового доступа к JBM-HH?
Если вы сомневаетесь, мы приглашаем вас всегда обращаться за помощью в VCC по телефону 703-696-0186/0189.
Закрывающая вкладка
Как я могу зарегистрироваться для пешеходного доступа к воротам Генри?
Ворота Генри открыты для всех держателей идентификационных карт Министерства обороны; однако вы ДОЛЖНЫ ЗАРЕГИСТРИРОВАТЬ свой идентификатор заранее. Пожалуйста, посетите или позвоните в Центр управления посетителями в Хэтфилд-Гейт (кампус Майер) в обычные рабочие часы.
Номер телефона 703-696-0186/0189.
Закрывающая вкладка
Как водители Uber/Lyft получают доступ к базе?
Все водители Uber, Lyft и такси, у которых нет удостоверения личности Министерства обороны США, должны следовать тем же базовым процедурам доступа, что и посетители.
Закрытие вкладки
Какие адреса мне нужны для перехода в Центры управления посетителями?
При использовании навигационной системы используйте следующие адреса:
ЦЕНТР КОНТРОЛЯ ПОСЕТИТЕЛЕЙ — HATFIELD GATE, MYER CAMPUS (VCC)
Корпус: S-507
29 Карпентер Роуд
Форт-Майер, 22211
ЦЕНТР КОНТРОЛЯ ПОСЕТИТЕЛЕЙ — ВОРОТА НА 2-Й УЛИЦЕ, КАМПУС MCNAIR (VCC)
Дом: 65
1600 2-я улица ЮЗ
Вашингтон, округ Колумбия, 20024
Закрывающая вкладка
ЧАСЫ ВОРОТ
| Имя шлюза | Описание ворот | Часы работы ворот в воскресенье | Часы работы ворот в понедельник | Время выхода на посадку по вторникам | Ворота Среда Часы | Часы работы ворот по четвергам | Часы работы ворот в пятницу | Часы работы ворот по субботам |
|---|---|---|---|---|---|---|---|---|
| Райт Гейт | Ворота Райта расположены в кампусе Майер на Маршалл-драйв и Норт-Мид-стрит, недалеко от шоссе 110. К ним могут получить доступ держатели карт Министерства обороны США. | 5:00 — 23:00 | 5:00 — 23:00 | 5:00 — 23:00 | 5:00 — 23:00 | 5:00 — 23:00 | 5:00 — 23:00 | 5:00 — 23:00 |
| Генри Гейт | Ворота Генри расположены в кампусе Майер на шоссе 50 и Норт-Першинг-драйв и доступны только для пешеходов с зарегистрированными удостоверениями Министерства обороны США — без транспортных средств. | 24/7 | 24/7 | 24/7 | 24/7 | 24/7 | 24/7 | 24/7 |
| Хендерсон Холл | Главные ворота Хендерсон-холла расположены на Саут-Орм-стрит и Саутгейт-роуд и доступны для владельцев удостоверений личности Министерства обороны США. | 6:00 — 19:00 | 6:00 — 19:00 | 6:00 — 19:00 | 6:00 — 19:00 | 6:00 — 19:00 | 6:00 — 19:00 | 6:00 — 19:00 |
| Ворота Хэтфилда и VCC | Hatfield Gate расположен в кампусе Майер на пересечении 2-й южной улицы на шоссе 27 (Вашингтонский бульвар). У этих ворот есть Центр управления посетителями, и к ним могут получить доступ владельцы удостоверений Министерства обороны США, коммерческие автомобили и посетители. | 24/7 | 24/7 | 24/7 | 24/7 | 24/7 | 24/7 | 24/7 |
| Ворота 2-й улицы и VCC | Ворота 2-й улицы расположены на 4-й улице и улице P в кампусе McNair JBM-HH. В нем есть Центр управления посетителями, и к нему могут получить доступ владельцы удостоверений личности Министерства обороны США, коммерческие автомобили и посетители. | закрытый | 8:00 — 16:00 | 8:00 — 16:00 | 8:00 — 16:00 | 8:00 — 16:00 | 8:00 — 16:00 | закрытый |
| Воскресенье | закрыто |
| Понедельник | 6:00 — 17:00 |
| Вторник | 6:00 — 17:00 |
| Среда | 6:00 — 17:00 |
| Четверг | 6:00 — 17:00 |
| Пятница | 6:00 — 17:00 |
| Суббота | 10:00 — 15:00 |
Корпус: S-507
29 Carpenter Road
Форт-Майер, 22211
| Воскресенье | закрыто |
| Понедельник | 8:00 — 16:00 |
| Вторник | 8:00 — 16:00 |
| Среда | 8:00 — 16:00 |
| Четверг | 8:00 — 16:00 |
| Пятница | 8:00 — 16:00 |
| Суббота | закрыто |
Здание: 65
1600 2nd Street SW
Вашингтон, округ Колумбия, 20024
ФОРМА ЗАПРОСА ДОСТУПА
ПОДАТЬ ЗАЯВКУ НА БАЗОВЫЙ ДОСТУП
БАЗОВАЯ КАРТА
ЗАЯВЛЕНИЕ ОБ ОТКАЗЕ
Коммерческий доступ
Для доступа к JBM-HH транспортные средства, используемые в коммерческих целях, такие как строительные / рабочие грузовики, фургоны, не предназначенные для пассажиров, движущиеся транспортные средства, полуприцепы, FEDEX, сельскохозяйственные транспортные средства (аренда сена), и т.
д. должны использовать Hatfield Gate для дополнительной проверки транспортных средств. Транспортные средства, использующие эти ACP, уже должны иметь пропуск на установку или значок установки.
Транспортные средства, предназначенные для перевозки пассажиров, в том числе: пассажирские фургоны, коммерческие автобусы и т. д., могут получить доступ к JBM-HH через Hatfield Gate.
Все коммерческие и крупногабаритные автомобили будут проверены и зарегистрированы. Накладная или счет-фактура должны содержать адрес установки. Все жильцы должны быть проверены или иметь удостоверение личности Министерства обороны США. Пенсионеры или иждивенцы, управляющие коммерческим транспортным средством, должны иметь пропуск или пропуск на установку.
Мотоциклы
В соответствии с Армейской программой безопасности, AR 385-10, CH 11-9, все водители, въезжающие в JBM-HH, должны иметь соответствующие лицензии и носить необходимые средства индивидуальной защиты для управления мотоциклом на посту.
СИЗ состоит из одобренного Департаментом транспорта шлема, защиты глаз, защиты ног, рубашки или куртки с длинным рукавом, длинных брюк, перчаток/рукавиц с полными пальцами.
Кроме того, IAW AR 385-10, CH 11-7a(5), водители мотоциклов должны успешно пройти все необходимые курсы обучения мотоциклам. Обучение технике безопасности на мотоциклах состоит из утвержденного MSF базового курса гонщиков (BRC), за которым следуют курсы опытных гонщиков (ERC) или курсы гонщиков военных спортивных мотоциклов (MSRC). По вопросам, касающимся этих требований, обращайтесь к AR 385-10 или звоните в отдел безопасности.
Зарегистрируйтесь для nib MediGap и/или GU Health Medical Gap Networks
Honeysuckle Health выступает в качестве агента nib по отношению к nib MediGap и сети GU Health Medical Gap. После того, как ваша регистрация будет подтверждена, вы сможете подавать заявки No Gap MediGap в nib, а заявки Known Gap — в GU Health.
Обратите внимание, что тарифные планы для nib MediGap и сети GU Health Medical Gap отличаются.
nib Правила и условия MediGap
nib Таблица тарифов MediGap
Положения и условия GU Health Medical Gap
График расценок GU Health Medical Gap
Я хотел бы зарегистрироваться на nib MediGap
Я хотел бы зарегистрироваться на GU Health Medical Gap
Я хотел бы зарегистрироваться на оба
Сведения о поставщике услуг
Имя поставщика услуг, специальность и местонахождение (места) будут опубликованы в каталогах участвующих фондов здравоохранения и поставщиков поставщиков-партнеров.
НазваниеПожалуйста, выберите вариантЗагрузка…
Имя
Отчество (необязательно)
Фамилия
Должно совпадать с регистрацией Medicare
Предпочтительное имя (необязательно)
AHPR A Номер
Медицинская специальность AHPRAПожалуйста, выберите вариантЗагрузка.
..
Банк-провайдер детали
Пожалуйста, добавьте номер(а) поставщика услуг Medicare, которого вы хотели бы зарегистрировать, и банковские реквизиты
Пожалуйста, не регистрируйте номера поставщика медицинских услуг.
Сведения о поставщике 1Номер поставщика
Номер счета
Имя счета
Добавляйте только дополнительные номера поставщиков для этого поставщика
Куда пациенты обращаются к этому поставщику?
Если консультационных кабинетов нет, укажите пригород, почтовый индекс и штат по основному месту практики AHPRA.
Эта информация будет опубликована в соответствии с Условиями.
Если провайдер работает в нескольких местах, вы можете указать каждое место.
Местонахождение 1Строка адреса 1 (необязательно)
Строка адреса 2 (необязательно)
Пригород
ШтатПожалуйста, выберите вариантACTNSWNTQLDSATASVICWA
9045 0 Почтовый индексТелефон (необязательно)
Электронная почта (необязательно)
Веб-сайт (необязательно)
Как с вами могут связаться Honeysuckle Health, nib или GU Health?
Honeysuckle Health будет использовать эту информацию, чтобы связываться с вами для получения обновлений, связанных с сетью.