hh-api 0.1.2

Async Python client for the HeadHunter (hh.ru) API with token refresh and typing.

hh-api

Современная асинхронная Python-библиотека для работы с API HeadHunter (hh.ru) с автоматическим управлением OAuth2-токенами и поддержкой multi-tenant архитектуры.

🎯 Ключевые особенности

• 🚀 Полностью асинхронная на базе httpx и asyncio
• 🔐 Умное управление OAuth2-токенами с автоматическим обновлением
• 🏢 Multi-tenant поддержка для работы с несколькими пользователями
• 💾 Гибкие хранилища токенов: память, JSON-файлы, Redis, база данных, переменные окружения
• 🔄 Автоматические повторные попытки при сетевых ошибках
• 🎭 Полная типизация для лучшей поддержки IDE
• 🛡️ Безопасность: защита от race conditions при обновлении токенов

📦 Установка

pip install hh-api

📚 API Reference

HHClient

Метод	Описание
search_vacancies(**params)	Поиск вакансий
get_vacancy(vacancy_id)	Получить детали вакансии
get_resume(resume_id)	Получить информацию о резюме
search_similar_vacancies(resume_id, **params)	Найти похожие вакансии
apply_to_vacancy(resume_id, vacancy_id, message)	Откликнуться на вакансию
get_dictionaries()	Получить справочники HH

TokenManager

Метод	Описание
authorization_url(subject, state?)	Сгенерировать URL для авторизации
exchange_code(subject, code)	Обменять код на токены
ensure_access(subject)	Получить действующий access token
refresh(subject, refresh_token?)	Обновить токены

🤝 Вклад в проект

Приветствуются pull requests! Для больших изменений сначала откройте issue для обсуждения.

1. Fork репозитория
2. Создайте ветку для фичи (git checkout -b feature/AmazingFeature)
3. Commit изменения (git commit -m 'Add some AmazingFeature')
4. Push в ветку (git push origin feature/AmazingFeature)
5. Откройте Pull Request

📄 Лицензия

Этот проект лицензирован под MIT License - см. файл LICENSE для деталей.

🙏 Благодарности

• HeadHunter API за отличную документацию
• httpx за прекрасный асинхронный HTTP-клиент
• Всем контрибьюторам проекта

📧 Контакты

iNetsmol - @inetsmol - [e-mail]

Ссылка на проект: https://github.com/inetsmol/hh-api