kirstepankov/myhhapi

PHP library to interact with hh.ru API

0.1.4 2022-11-04 21:37 UTC

Requires

• ext-curl: *
• curl/curl: ^2.4

MIT

• Степанков Кирилл

• php
• api
• hh
• headhunter

README

composer require kirstepankov/myhhapi

Ведётся разработка новых сервисов! Список будет пополняться со временем

My Headhunter API

Без усилий получите данные от HH

Предисловие

В данной библиотеки реализованы только те методы, которые мне захотелось описать. Если вы захотите использовать её, но в ней нет того, что вам нужно, обязательно пишите в issue. Как только замечу предложение, сразу обращу на него своё внимание. Телега для связи

Навигация

• Получение вакансии по id
• Получение нескольких вакансий по условиям
• Получение похожих вакансий относительно другой вакансии
• Поиск работодателей по параметрам
• Поиск работодателя по id
• Получение всех спициальностей
• Получение всех отраслей компаний

Список всех сервисов

❗ Ссылки ведут на доку HH

• vacancy (Поиск резюме по id)
• vacancies (Поиск вакансии по условиям)
• vacanciesSimilar (Поисх похожих вакансий)
• employers (Поиск работодателя)
• employer (Поиск работодателя по id)
• specializations (Специализации)
• industries (Отрасли компаний)

Документация

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

Обязательно заполняем все три метода. Данные выдаются в лк dev.hh.ru после регистрации приложения. Для всех методов, которые уже раелизованы в данной библиотеки токен НЕ ТРЕБУЕТСЯ

use MyHHAPI\OAuth\OAuthForApplication;

$oauth = new OAuthForApplication();

$oauth->setGrantType('');
$oauth->setClientId('');
$oauth->setClientSecret('');

$token = $oauth->getAccessToken();
var_dump($token);

Получуние конкретной вакансии по id

Вызываем фабрику

use MyHHAPI\MyHHAPIFactory;
$factory = new MyHHAPIFactory();

В метод getService необходимо передать id сервиса. Все сервиси описаны в п "Список всех сервисов"

$service = $factory->getService('vacancy');

В объект добавляем id вакансии с ключом idVacancy

$service->setQueryFields([
    'idVacancy' => 00000000,
]);

Выводим полученные данные от АПИ

$data = $service->getData();
var_dump($data);

Получуние вакансий по условиям

Вызываем фабрику

use MyHHAPI\MyHHAPIFactory;
$factory = new MyHHAPIFactory();

В метод getService необходимо передать id сервиса. Все сервиси описаны в п "Список всех сервисов"

$service = $factory->getService('vacancies');

Заполняем объект обязательными и необязательными параметрами

$service->setQueryFields([
    'text' => 'Java',
]);

Выводим полученные данные от АПИ

$data = $service->getData();
var_dump($data);

Получуние похожих вакансий

Вызываем фабрику

use MyHHAPI\MyHHAPIFactory;
$factory = new MyHHAPIFactory();

В метод getService необходимо передать id сервиса. Все сервиси описаны в п "Список всех сервисов"

$service = $factory->getService('vacanciesSimilar');

В объект добавляем id вакансии с ключом idVacancy

$service->setQueryFields([
    'idVacancy' => 00000000,
]);

Выводим полученные данные от АПИ

$data = $service->getData();
var_dump($data);

Поиск работодателей по параметрам

Вызываем фабрику

use MyHHAPI\MyHHAPIFactory;
$factory = new MyHHAPIFactory();

В метод getService необходимо передать id сервиса. Все сервиси описаны в п "Список всех сервисов"

$service = $factory->getService('employers');

В объект добавляем нужные параметры

$service->setQueryFields([
    'locale' => 'EN',
    'host' => 'hh.kz'
]);

Выводим полученные данные от АПИ

$data = $service->getData();
var_dump($data);

Поиск работодателя по id

Вызываем фабрику

use MyHHAPI\MyHHAPIFactory;
$factory = new MyHHAPIFactory();

В метод getService необходимо передать id сервиса. Все сервиси описаны в п "Список всех сервисов"

$service = $factory->getService('employer');

В объект добавляем нужные параметры. Причём employer_id является обязательным, а другие поля нет

$service->setQueryFields([
    'employer_id' => 0000000,
    'locale' => 'EN',
    'host' => 'hh.kz'
]);

Выводим полученные данные от АПИ

$data = $service->getData();
var_dump($data);

Получение всех специальностей

Вызываем фабрику

use MyHHAPI\MyHHAPIFactory;
$factory = new MyHHAPIFactory();

В метод getService необходимо передать id сервиса. Все сервиси описаны в п "Список всех сервисов"

$service = $factory->getService('specializations');

Выводим полученные данные от АПИ

$data = $service->getData();
var_dump($data);

Получение всех отраслей компаний

Вызываем фабрику

use MyHHAPI\MyHHAPIFactory;
$factory = new MyHHAPIFactory();

В метод getService необходимо передать id сервиса. Все сервиси описаны в п "Список всех сервисов"

$service = $factory->getService('industries');

Выводим полученные данные от АПИ

$data = $service->getData();
var_dump($data);