⬆️ ⬇️

New API HeadHunter and termination of support for API 1.0

Some people know that we have an API, a software interface that allows us to “communicate” with the hh.ru platform for mobile and desktop applications, other sites and just widgets, including the one to the right of this article on our blog page.



We are pleased to announce that a new, completely reworked version of the API is replacing the current implementation.



Our goal was to make the product more consistent, predictable, understandable and friendly, to minimize the need to study the documentation and cases of the “hardcode” of any things on the client side. To achieve this, we decided to abandon support for backward compatibility with API 1.0 and create everything from scratch, rethinking the whole project.



To focus on functionality, we abandoned the XML version, corrected method names and grouped them into logical entities, hiding low-level moments from the user. The result is a new HTTP REST JSON API. As soon as we have stepped over the functionality of the previous version, we open it officially.

')

In the new version, we have rejected versioning: now the API will be developed incrementally, with full support for backward compatibility. Gradually all functionality of hh.ru will be covered. Already available authorization in a third-party application using a user account. To do this, we use the OAuth2 protocol, which allows us to provide access to personal user data without disclosing your login / password to third-party applications. Also now, developers can access the list of resumes of an authorized applicant, use the advanced job search and "selected vacancies". Gradually, the missing services of the applicant will be released: creating / editing resumes, auto searches for vacancies. After that, functionality for employers will appear: search for a resume, publication of vacancies and much more.



In addition to the “low-level” HTTP, there are plans to develop client libraries for popular programming languages ​​(Java, Python, Javascript), as well as designers of ready-made widgets. This will further reduce the “entry threshold” for using our API, and with the help of widget configurators, anyone can create widgets for their site without using a programmer’s resource.



The first version ( http://api.hh.ru ) will be available for at least another 3 months; during this time, developers must transfer their applications to the new version. In the fall, temporary outages will begin and the exact date of API 1.0 shutdown will be reported.



Documentation and more information about the new API is located at https://github.com/hhru/api . There is also an Issues section where you can suggest any improvements, leave a request for revision, or report a problem. You can also contact the developers directly via Twitter: @apihhru .

Source: https://habr.com/ru/post/186994/



All Articles