get_equipment_attendance_state (장비 출근 상태 조회)
본인 장비의 현장 출근 상태를 조회합니다.
기본 정보
| 항목 |
값 |
| URL |
https://asia-northeast3-construction24-test.cloudfunctions.net/get_equipment_attendance_state |
| Method |
POST |
| 인증 |
Firebase ID Token 필요 |
| 권한 |
해당 현장의 장비 소유자여야 함 |
요청
| 헤더 |
값 |
필수 |
설명 |
| Authorization |
Bearer |
O |
Firebase ID Token |
| Content-Type |
application/json |
O |
- |
Body
| 필드 |
타입 |
필수 |
설명 |
검증 |
| company_id |
string |
O |
회사 ID |
- |
| site_id |
string |
O |
현장 ID |
- |
요청 예시
{
"company_id": "company123",
"site_id": "site456"
}
응답
성공 (200)
{
"attendance_state": "check_in"
}
또는
{
"attendance_state": "check_out"
}
실패
| 코드 |
message |
원인 |
| 500 |
"해당 현장의 장비 멤버가 아닙니다." |
요청자 소유의 장비가 현장에 없음 |
| 500 |
"{에러메시지}" |
서버 내부 오류 |
응답 값 설명
| 값 |
설명 |
| check_in |
현재 출근 중 (퇴근 처리되지 않은 출근 기록이 있음) |
| check_out |
퇴근 상태 (출근 기록이 없거나 모두 퇴근 처리됨) |
참고
- link=False인 장비 출근 로그가 있으면 check_in, 없으면 check_out으로 판단합니다.
- 관련 API: equipment_check_in_request, equipment_check_out_request