equipment_check_in_request (장비 출근 요청)
현장에 장비 출근 체크를 요청합니다.
기본 정보
| 항목 |
값 |
| URL |
https://asia-northeast3-construction24-test.cloudfunctions.net/equipment_check_in_request |
| 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 |
- |
| equipment_id |
string |
O |
장비 ID |
- |
요청 예시
{
"company_id": "company123",
"site_id": "site456",
"equipment_id": "equipment789"
}
응답
성공 (200)
{
"message": "장비 출근 요청이 전송되었습니다."
}
실패
| 코드 |
message |
원인 |
| 400 |
"이미 장비 출근 요청이 있습니다." |
이미 pending 상태의 출근 요청이 있음 |
| 400 |
"하루에 장비 출근 요청은 3번까지만 가능합니다." |
당일 출근 로그가 3개 이상 |
| 400 |
"이미 장비 출근 체크가 되어있습니다." |
이미 출근 중인 상태 |
| 400 |
"현장 변경 요청이 처리 중이므로 출근이 불가합니다." |
장비 현장 변경 요청이 pending 상태 |
| 403 |
"무사고 동의서를 먼저 제출해주세요." |
무사고 동의서 미제출 |
| 500 |
"해당 현장의 장비 멤버가 아닙니다." |
장비가 현장에 배정되어 있지 않음 |
| 500 |
"해당 장비의 소유자가 아닙니다." |
요청자가 장비 소유자가 아님 |
| 500 |
"{에러메시지}" |
서버 내부 오류 |
참고
- 하루에 최대 3번까지 출근 요청이 가능합니다.
- 요청 후 현장 관리자의 승인이 필요합니다.
- 출근 전 무사고 동의서를 제출해야 합니다. (get_safety_agreement_upload_token)
- 관련 API: equipment_check_in_request_approval, equipment_check_out_request