従業員履歴の取得
リクエスト
エンドポイント
実行先のURLについて詳しくは、「APIエンドポイント」をご覧ください。
| HTTPメソッド | APIパス | 用途 | マスタ管理プラスオプション必須 |
|---|---|---|---|
| GET | /api/v22.10/members/<従業員のID>/histories | 特定従業員の変更履歴を取得 | 〇 |
パスパラメータ
| エンドポイント内の表記 | 必須 | データ形式 | デフォルト値 | 説明 |
|---|---|---|---|---|
| <従業員のID> | 〇 | 文字列 | ー | 従業員のID |
クエリパラメータ
不要
リクエストヘッダ
「APIリクエストヘッダ」をご覧ください。
リクエストボディ
不要
レスポンス
レスポンスボディ
| 項目名 | データ形式 | 説明 |
|---|---|---|
| histories | historyオブジェクトの配列 ※各要素の属性は、「historyオブジェクト」をご覧ください | 特定従業員に紐づく属性値の履歴 |
historyオブジェクト
| 項目名 | データ形式 | 説明 |
|---|---|---|
| date | 文字列 (YYYY-MM-DD形式) | 「changedAttributes」属性にて登録されている変更が行われた日付 |
| changedAttributes | changedAttributeオブジェクトの配列 ※各要素の属性は、「changedAttributeオブジェクト」をご覧ください | 変更された属性の情報 |
changedAttributeオブジェクト
| 項目名 | データ形式 | 説明 |
|---|---|---|
| previosValue | 「dataType」に応じた形式 | 変更前の属性の値 存在しない場合はnull |
| value | 「dataType」に応じた形式 | 変更後の属性の値 値が削除される場合はnull |
| dataType | 文字列 | 属性値のデータ形式 |
| attributeId | 文字列 | 属性のID |
| attributeLabel | 文字列 | 属性の名称 |
| referenceId | 文字列 | 所属先のID 会社・組織・事務所・プロジェクトに所属している従業員に付与される属性の場合に利用 |
| referenceName | 文字列 または null | 所属先のID 会社・組織・事務所・プロジェクトに所属している従業員に付与される属性の場合に利用 |
| referenceType | 文字列 または null | 所属先のID 会社・組織・事務所・プロジェクトに所属している従業員に付与される属性の場合に利用 |
| setId | 文字列 | マルチプル項目※1のID マルチプル項目ではない場合、「AAAAAAAAAAAAAAAAAAAAAA」が設定される |
| entityId | 文字列 | 従業員のID |
| date | 文字列 (YYYY-MM-DD形式) | 変更された日付 |
※1：事前に選択肢が決められている属性値の総称です。