equipment_check_out_request_approval (장비 퇴근 요청 승인/거절)
현장 관리자가 장비 퇴근 요청을 승인하거나 거절합니다.
기본 정보
| 항목 |
값 |
| URL |
https://asia-northeast3-construction24-test.cloudfunctions.net/equipment_check_out_request_approval |
| 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 |
- |
| request_ids |
array |
O |
처리할 요청 ID 배열 |
- |
| request_state |
string |
O |
처리 상태 |
approved 또는 rejected |
요청 예시
{
"company_id": "company123",
"site_id": "site456",
"request_ids": ["request1", "request2"],
"request_state": "approved"
}
응답
성공 (200)
{
"message": "장비 퇴근 체크 요청 처리 완료",
"fail_list": []
}
부분 실패 시
{
"message": "장비 퇴근 체크 요청 처리 완료",
"fail_list": [
{"request_id": "request1", "error": "존재하지 않는 요청입니다."},
{"request_id": "request2", "error": "장비 출근 체크가 되어있지 않습니다."}
]
}
실패
| 코드 |
message |
원인 |
| 500 |
"해당 회사의 멤버가 아닙니다." |
요청자가 회사 멤버가 아님 |
| 400 |
"올바르지 않은 상태입니다." |
request_state가 approved/rejected가 아님 |
| 500 |
"{에러메시지}" |
서버 내부 오류 |
개별 요청 실패 사유 (fail_list)
| error |
원인 |
| "존재하지 않는 요청입니다." |
request_id에 해당하는 요청이 없음 |
| "장비 퇴근 요청이 아닙니다." |
type이 check_out이 아님 |
| "이미 처리된 요청입니다." |
status가 pending이 아님 |
| "장비 출근 체크가 되어있지 않습니다." |
link=False인 출근 로그가 없음 |
참고
- 여러 요청을 한 번에 처리할 수 있습니다.
- 승인 시 출근 로그에 퇴근 시간이 기록되고 link=True로 변경됩니다.
- 관련 API: equipment_check_out_request, equipment_check_in_request_approval