新しいHeadHunter APIおよびAPI 1.0の廃止

一部の人々は、私たちがAPIを持っていることを知っています。これは、モバイルおよびデスクトップアプリケーション、他のサイト、およびブログページのこの記事の右側を含むウィジェットだけを、 hh.ruプラットフォームと「通信」できるプログラムインターフェイスです。



現在の実装が、APIの完全に再設計された新しいバージョンに置き換えられていることをお知らせします。



私たちの目標は、製品の一貫性、予測可能性、わかりやすさ、使いやすさを向上させ、クライアント側のあらゆるもののドキュメントや「ハードコード」のケースを調べる必要性を最小限に抑えることでした。 これを達成するために、API 1.0との後方互換性のサポートを中止し、すべてをゼロから作成して、プロジェクト全体を再考することにしました。



機能に焦点を合わせるために、XMLバージョンを放棄し、メソッドの名前を調整し、それらを論理エンティティにグループ化して、低レベルの瞬間をユーザーから隠しました。 結果は、新しいHTTP REST JSON APIです。 以前のバージョンの機能の範囲を超えてすぐに、公式に開きます。



新しいバージョンでは、バージョン管理を廃止しました。現在、APIは下位互換性を完全にサポートしながら、徐々に大きくなります。 徐々に、すべてのhh.ru機能がカバーされます。 ユーザーアカウントを使用したサードパーティアプリケーションでの承認は既に利用可能です。 これを行うには、OAuth2プロトコルを使用します。これにより、ユーザー名/パスワードをサードパーティのアプリケーションに公開することなく、ユーザーの個人データへのアクセスを提供できます。 また、開発者は承認された求職者の履歴書のリストにアクセスし、空席と「選択した空席」の詳細検索を使用できます。 徐々に、応募者の不足しているサービスが出てきます：履歴書の作成/編集、空席の自動検索。 その後、雇用主向けの機能が表示されます：履歴書の検索、空席の公開など。



「低レベル」HTTPに加えて、一般的なプログラミング言語（Java、Python、Javascript）のクライアントライブラリ、および既製のウィジェットコンストラクターを開発する計画があります。 これにより、APIを使用するための「エントリのしきい値」がさらに削減され、ウィジェットコンフィギュレーターの助けを借りて、誰でもプログラマーのリソースを必要とせずにサイトのウィジェットを作成できます。



最初のバージョン（ http://api.hh.ru ）は少なくとも3か月間利用可能になります。その間、開発者はアプリケーションを新しいバージョンに移行する必要があります。 秋には、一時的な停止が始まり、API 1.0のシャットダウンの正確な日付が報告されます。



新しいAPIに関するドキュメントと詳細情報は、 https：//github.com/hhru/apiにあります 。 問題のセクションもあり、改善を提供したり、修正を依頼したり、問題を報告したりできます。 また、Twitterを介して開発者に直接連絡することもできます： @apihhru 。