採用一括かんりくんAPI（新卒版） v1 (1.0)

アクセストークンを発行します。

かんりくんに登録されている学生の情報を取得することができます。

かんりくんに学生を登録することができます。
トークン種別に応じて Request body の契約が異なります。下記 oneOf を切り替えて確認してください。
送信された値に問題がある場合はレスポンスデータのerrorsにエラー内容が出力されます。

{
  student_id: null,
  errors: [
    "日付の形式に誤りがあります"
  ] 
}

紹介会社クレデンシャル時の注意

推奨する呼び出し手順

求人へ学生を紹介する前に、次の順で API を呼び出してください。
1. （任意）GET /new-graduate/v1.0/item/job で紹介可能な求人を確認してください
2. GET /new-graduate/v1.0/item/job_entry_form_field?job_id={求人ID} で、その求人のエントリーフォーム項目（必須／任意・型・選択肢）を取得してください
3. 取得結果の fields[].key / ef_items[].key と required を見て、本 API（POST /new-graduate/v1.0/student/add）の Request body を組み立ててください（自由項目も GET の key をトップレベルに指定）

送信すべき項目・必須可否は求人ごとに異なります。固定の項目一覧だけを前提にせず、必ず手順 2 の結果に従ってください。
fields に含まれない項目（使用しない項目）を送っても保存されません。

・job_id（公開済み・募集中の求人）が必須です。
・entry_root_id を送信しても無視されます。
・メールアドレスと電話番号など Agent 準拠の条件で重複と判定された場合はエラーを返します。

かんりくんに登録されている学生を指定したイベントに予約させることができます。
送信された値に問題がある場合はレスポンスデータのerrorsにエラー内容が出力されます。

{
  errors: [
    "必須項目が設定されていません。"
  ] 
}

トークン種別に応じて挙動が異なります。

採用企業クレデンシャル

イベントが満席であっても予約が実行されます。
定員（capacity）を超えた予約も可能となりますので、ご利用の際はご注意ください。
同一イベントへの重複予約は HTTP 409 です。
満席かどうかの確認が必要な場合は、事前にイベント情報を取得して定員と現在の予約数を確認してください。

紹介会社クレデンシャル

かんりくん Agent のイベント予約に準拠します。
・当該紹介会社に公開済みかつ現在予約可能なイベントのみ予約できます（event/get と同条件を予約時にも再検証します）。
・自社が紹介した学生のみ予約できます。
・満席の場合は HTTP 400（「このイベントは定員に達しています。」）を返します（事前チェックのみ）。
・同一イベントへの有効予約済み、同一選考段階の別イベント予約済み、対象外・不合格辞退なども HTTP 400 です。

かんりくんに登録されているイベントの情報を取得することができます。

トークン種別に応じて Response の契約が異なります。下記 Response の oneOf を切り替えて確認してください。
紹介会社クレデンシャルでは、当該紹介会社に公開済みかつ現在予約可能なイベントのみ返します（レスポンスに webmeeting_url / responsible_persons / reservation_url / evaluation_url は含みません）。Request の search.webmeeting_url は紹介会社クレデンシャルでは無視されます（送ってもエラーになりません）。

かんりくんにイベントに付帯する汎用的な情報を追加することができます。
送信された値に問題がある場合はレスポンスデータのerrorsにエラー内容が出力されます。

エントリーフォーム自由追加項目を取得します

学生情報追加項目を取得します。nameパラメータを指定した場合、完全一致のレコードのみが取得できます。

学生情報追加項目を登録します

エントリー経路を取得します

求人を取得します。紹介会社クレデンシャルでは公開済み・募集中の求人のみ返します。

紹介会社クレデンシャル専用です。指定求人のエントリーフォーム項目（必須／任意・型・選択肢）を取得します。
標準項目は fields、ユーザ作成設問（自由項目）は ef_items に分かれます。ef_items[].key は ef_item.id の数値文字列です。
紹介登録（student/add）では、fields[].key および ef_items[].key をそのまま Request body のトップレベルキーとして指定してください。
status=0（使用しない）の項目は返しません。公開済み・募集中の求人のみ取得できます。

answer_type: 1=テキスト（文字列） / 2=テキストエリア（文字列） / 3=チェックボックス（文字列配列） / 4=セレクト（文字列） / 5=ラジオ（文字列） / 6=ファイル（file_name と Base64 形式の file_data を持つオブジェクト） / date=実在する YYYY-MM-DD / month=実在する YYYY-MM または YYYY/MM / employment_history=配列または同形式の JSON 文字列。職歴の要素は term_start・term_end・company_name が必須で、department_position・details は任意です。都道府県は options の 01〜47、graduate はサービス年度の春・秋、final_education_status は options の 1〜11 を使用します。