【事前告知】9月28日（月）API仕様変更のお知らせ
公開日：2026年9月24日
2026年9月28日（月）夜に、APIのURL・検索条件・取得データの形式を変更する予定です。 APIをご利用のお客様は、切替に合わせて設定・プログラムの変更をお願いいたします。
Web画面で保存済みの検索条件は引き継がれます。お客様による再設定は不要です。本変更に伴う修正が必要なのは、APIを利用した外部連携です。
変更内容
1. APIのURL
企業を表す名称を corporates から companies に統一します。以下は /rest/v1 以降の変更です。
| 対象 | 変更前 | 変更後 |
|---|---|---|
| 企業検索 | POST /corporates/search | POST /companies/search |
| グループ企業一覧 | POST /corporates/group-companies | GET /companies/{corporateNumber}/group-companies |
| 求人詳細 | GET /jobs/{jobId}/detail | GET /jobs/{jobId} |
企業詳細を取得する GET /companies/{corporateNumber} と、企業の求人一覧を取得する GET /companies/{corporateNumber}/jobs も追加します。
2. 検索条件（AND／ORフィルター）
企業・求人検索APIの filters と filterGroups を filter に統一します。AND／ORの指定を含め、APIに送信する検索条件を新しい形式に書き換える必要があります。
3. 取得データの形式
検索結果は { total, items } 形式になります。また、求人データに含まれる企業情報は company の中にまとまります。データを読み取るプログラムも修正が必要です。
お客様へのお願い
切替前に修正を準備し、切替後に新しいURL・形式へ変更してください。 旧URL・旧形式は利用できなくなります。
切替後の詳しいAPI仕様は、APIドキュメントをご確認ください。
APIを使っていない場合、対応事項はありません。