get_equipment_info (장비 정보 조회)
특정 장비의 상세 정보를 조회합니다. (복호화된 정보 반환)
기본 정보
| 항목 |
값 |
| URL |
https://asia-northeast3-construction24-test.cloudfunctions.net/get_equipment_info |
| Method |
POST |
| 인증 |
Firebase ID Token 필요 |
| 권한 |
해당 회사의 멤버 또는 장비 소유자 |
요청
Body
| 필드 |
타입 |
필수 |
설명 |
검증 |
| token |
string |
O |
Firebase ID Token |
- |
| company_id |
string |
O |
회사 ID |
- |
| site_id |
string |
O |
현장 ID |
- |
| equipment_id |
string |
O |
장비 ID |
- |
요청 예시
{
"token": "eyJhbGci...",
"company_id": "abc123",
"site_id": "site456",
"equipment_id": "equip789"
}
응답
성공 (200)
{
"equipment_info": {
"equipment_name": "굴삭기 1호",
"equipment_number": "12가3456",
"equipment_type": "굴삭기",
"UID": "owner123",
"lessor_company_name": "대한중장비",
"main_address": "서울시 강남구",
"sub_address": "테헤란로 123",
"email": "owner@example.com",
"phone": "01012345678",
"lessor_registration_number": "123-45-67890",
"created_at": "2024-03-15T10:30:00+09:00"
}
}
실패
| 코드 |
message |
원인 |
| 400 |
"장비 정보를 찾을 수 없습니다." |
해당 장비가 존재하지 않는 경우 |
| 400 |
"권한이 없습니다." |
회사 멤버도 아니고 장비 소유자도 아닌 경우 |
| 500 |
"장비 정보 조회 실패" |
서버 오류 |
참고
- 이메일(email), 연락처(phone), 상세 주소(sub_address)는 AES 복호화되어 평문으로 반환됩니다.
- datetime 필드들은 ISO 8601 형식의 문자열로 변환되어 반환됩니다.
- 관련 API: [[edit_equipment_info]], [[edit_equipment_lessor_info]]