API_REC_0102_履歴追加¶
概要¶
勤怠情報を履歴に追加する。
リクエスト¶
HTTPリクエスト¶
| HTTPメソッド | URL |
|---|---|
| POST | /api/users/{userId}/records |
パスパラメーター¶
| 変数名 | 型 | 必須 | 論理名 | デフォルト値 | 制限 | 例 |
|---|---|---|---|---|---|---|
| userId | string | ✅ | ユーザID | - | ULID形式 | 01D0KDBRASGD5HRSNDCKA0AH53 |
クエリパラメーター¶
なし
リクエストボディ¶
| リクエストサンプル | |
|---|---|
1 2 3 4 5 6 | |
| 変数名 | 型 | 必須 | 論理名 | 形式 |
|---|---|---|---|---|
| date | date | ✅ | 日付 | yyyy/mm/dd |
| startTime | string | ✅ | 開始時間 | hh:mm |
| endTime | string|null | ✅ | 終了時間 | hh:mm |
| isHome | boolean | ✅ | 在宅フラグ | true=在宅 false=出社 |
レスポンス¶
200 OK¶
| レスポンスサンプル | |
|---|---|
1 2 3 | |
| 変数名 | 型 | 必須 | 論理名 | 形式 |
|---|---|---|---|---|
| recordId | string | ✅ | 履歴ID | ULID形式 |
エラーレスポンス¶
404 Not Found¶
| err_code | err_message | 説明 |
|---|---|---|
| E4041 | userId is not found. | ユーザが見つからなかった場合 |
409 Conflict¶
| err_code | err_message | 説明 |
|---|---|---|
| E4091 | record is already registered. | すでに同じ日に登録されていた場合 |
500 Internal Server Error¶
| err_code | err_message |
|---|---|
| E5001 | Failed to auth server. |