API_REC_0101_履歴取得¶

概要¶

履歴の一覧を取得する

リクエスト¶

HTTPリクエスト¶

HTTPメソッド	URL
GET	/api/users/records

パスパラメーター¶

なし

クエリパラメーター¶

変数名	型	必須	論理名	デフォルト値	制限	例
userId	array(string)	✅	ユーザIDリスト	-	ULID形式	01D0KDBRASGD5HRSNDCKA0AH53
month	string	✅	取得する年月	-	-	2025/10

リクエストボディ¶

なし

レスポンス¶

200 OK¶

レスポンスサンプル
{
  "records": [
    {
      "date": "2025/10/20",
      "startTime": "08:56",
      "endTime": "18:15",
      "isHome": false
    },
    {
      "date": "2025/10/21",
      "startTime": "08:58",
      "endTime": "18:21",
      "isHome": true
    }
  ]
}

変数名	型	必須	論理名	形式
records	array(obj)	✅	履歴一覧
records > date	date	✅	日付	yyyy/mm/dd
records > startTime	string	✅	開始時間	hh:mm
records > endTime	string\|null	✅	終了時間	hh:mm
records > isHome	boolean	✅	在宅フラグ	true=在宅 false=出社

エラーレスポンス¶

404 Not Found¶

err_code	err_message	説明
E4041	userId is not found.	ユーザが見つからなかった場合

500 Internal Server Error¶

err_code	err_message
E5001	Failed to auth server.