勤怠 リファレンス

出勤・退勤の打刻、打刻状態の取得、打刻履歴の参照を行います。

• POST/api/v1/attendance/punches— 打刻を記録
• GET/api/v1/attendance/punches/status— 現在の打刻状態を取得
• GET/api/v1/attendance/punches/history— 打刻履歴を取得

勤怠の概要・ダッシュボード情報を取得します。

• GET/api/v1/attendance/overview— 勤怠概要を取得
• GET/api/v1/attendance/dashboard— ダッシュボードを取得

勤怠記録の修正申請・承認・却下を行います。

• GET/api/v1/attendance/corrections— 修正申請一覧を取得
• POST/api/v1/attendance/corrections— 修正を申請
• POST/api/v1/attendance/corrections/{id}/approve— 修正を承認
• POST/api/v1/attendance/corrections/{id}/reject— 修正を却下

休暇申請の作成・一覧・承認・却下を行います。

• GET/api/v1/attendance/leave-requests— 休暇申請一覧を取得
• POST/api/v1/attendance/leave-requests— 休暇を申請
• POST/api/v1/attendance/leave-requests/{id}/approve— 休暇申請を承認
• POST/api/v1/attendance/leave-requests/{id}/reject— 休暇申請を却下

残業申請の作成・一覧・承認・却下を行います。

• GET/api/v1/attendance/overtime-requests— 残業申請一覧を取得
• POST/api/v1/attendance/overtime-requests— 残業を申請
• POST/api/v1/attendance/overtime-requests/{id}/approve— 残業申請を承認
• POST/api/v1/attendance/overtime-requests/{id}/reject— 残業申請を却下

月次勤怠の提出・確認を行います。

• GET/api/v1/attendance/submissions— 提出一覧を取得
• POST/api/v1/attendance/submissions— 勤怠を提出
• POST/api/v1/attendance/submissions/{id}/confirm— 提出を確認

休暇残日数の取得・付与日数の設定を行います。

• GET/api/v1/attendance/leave-balances/me— 自分の休暇残日数を取得
• GET/api/v1/attendance/leave-balances— 組織の休暇残日数一覧を取得
• POST/api/v1/attendance/leave-balances— 休暇付与日数を設定

月次レポート・エクスポートデータを取得します。

• GET/api/v1/attendance/reports/my-monthly— 自分の月次レポートを取得
• GET/api/v1/attendance/reports/monthly— 組織の月次レポートを取得
• GET/api/v1/attendance/exports/csv— CSV エクスポート
• GET/api/v1/attendance/exports/pdf— PDF エクスポート

メンバーの一覧・概要・Slack 招待・ロール更新を行います。

• GET/api/v1/attendance/members— メンバー一覧を取得
• GET/api/v1/attendance/members/overview— メンバー概要を取得
• POST/api/v1/attendance/members/invite-slack— Slack で招待
• PATCH/api/v1/attendance/members/update-role— メンバーのロールを更新

勤怠の組織設定（就業時間・休日など）を管理します。

• GET/api/v1/attendance/settings— 勤怠設定を取得
• PATCH/api/v1/attendance/settings— 勤怠設定を更新
• GET/api/v1/attendance/settings/holidays— 祝日一覧を取得
• POST/api/v1/attendance/settings/holidays— 祝日を追加
• DELETE/api/v1/attendance/settings/holidays/{id}— 祝日を削除

部署・役職の管理を行います。

• GET/api/v1/attendance/org/departments— 部署一覧を取得
• POST/api/v1/attendance/org/departments— 部署を作成
• POST/api/v1/attendance/org/departments/batch— 部署を一括作成
• DELETE/api/v1/attendance/org/departments/{id}— 部署を削除
• GET/api/v1/attendance/org/positions— 役職一覧を取得
• POST/api/v1/attendance/org/positions— 役職を作成
• POST/api/v1/attendance/org/positions/batch— 役職を一括作成
• DELETE/api/v1/attendance/org/positions/{id}— 役職を削除

勤怠データの変更履歴を参照します。

• GET/api/v1/attendance/audit-logs— 監査ログを取得