add_site_attendance_log (현장 출퇴근 로그 추가)
관리자가 현장 출퇴근 로그를 직접 추가합니다.
기본 정보
| 항목 |
값 |
| URL |
https://asia-northeast3-construction24-test.cloudfunctions.net/add_site_attendance_log |
| Method |
POST |
| 인증 |
Firebase ID Token 필요 |
| 권한 |
회사 멤버여야 함 |
요청
| 헤더 |
값 |
필수 |
설명 |
| Authorization |
Bearer |
O |
Firebase ID Token |
| Content-Type |
application/json |
O |
- |
Body
| 필드 |
타입 |
필수 |
설명 |
검증 |
| target_member_id |
string |
O |
대상 멤버 ID (UID) |
- |
| company_id |
string |
O |
회사 ID |
- |
| site_id |
string |
O |
현장 ID |
- |
| check_in_at |
string |
O |
출근 시간 |
ISO8601 형식 |
| check_out_at |
string |
O |
퇴근 시간 |
ISO8601 형식 |
| memo |
string |
O |
메모 |
- |
| task_id |
string |
X |
작업 ID (선택) |
- |
요청 예시
{
"target_member_id": "user789",
"company_id": "company123",
"site_id": "site456",
"check_in_at": "2025-07-21T09:00:00.000Z",
"check_out_at": "2025-07-21T18:00:00.000Z",
"memo": "수기 입력"
}
응답
성공 (200)
{
"success": true,
"message": "현장 출근/퇴근 로그가 추가되었습니다.",
"log_id": "생성된 로그 ID"
}
실패
| 코드 |
message |
원인 |
| 500 |
"해당 회사의 멤버가 아닙니다." |
요청자가 회사 멤버가 아님 |
| 500 |
"해당 현장의 멤버가 아닙니다." |
대상이 현장 멤버가 아님 |
| 500 |
"이미 현장 출근중인 대상은 기록을 추가 할 수 없습니다." |
대상이 현재 출근 중 |
| 500 |
"{에러메시지}" |
서버 내부 오류 |
참고
- 이미 출근 중인 상태(link=False인 출근 로그가 있음)에서는 로그를 추가할 수 없습니다.
- 추가된 로그는 link=True로 생성되어 바로 완료된 출퇴근으로 기록됩니다.
- 관련 API: delete_site_attendance_log, site_admin_check_out