{"openapi":"3.0.0","info":{"title":"5D 데이터 연동 API","description":"5D 시스템에서 공유되는 데이터를 수집, 제공하기 위한 API TEST","contact":{"email":"khs1994@metabuild.co.kr"},"version":"1.0.2"},"servers":[{"description":"SwaggerHub API Auto Mocking","url":"https://virtserver.swaggerhub.com/HyunSeung94/5D.Service/1.0.2"}],"components":{"schemas":{"building":{"description":"건축물 프로파일","type":"object","properties":{"id":{"type":"string","description":"시설물 ID"},"addr_old":{"type":"string","description":"대지위치"},"addr_old_sgg":{"type":"string","description":"시군구코드"},"addr_old_emd":{"type":"string","description":"법정동코드"},"addr_old_san":{"type":"string","description":"대지구분코드"},"addr_old_main":{"type":"string","description":"본번"},"addr_old_sub":{"type":"string","description":"부번"},"addr_old_pnu":{"type":"string","description":"토지코드"},"building_ledger":{"type":"string","description":"관리건축물대장_PK"},"addr":{"type":"string","description":"새주소대지위치"},"addr_road_code":{"type":"string","description":"새주소도로코드"},"addr_emd":{"type":"string","description":"새주소법정동코드"},"addr_is_under":{"type":"string","description":"새주소지하코드"},"addr_main":{"type":"integer","format":"int32","description":"새주소본번"},"addr_sub":{"type":"integer","format":"int32","description":"새주소부번"},"building_name":{"type":"string","description":"건물명칭"},"building_number":{"type":"string","description":"동명칭"},"land_area":{"type":"number","format":"double","description":"건물통합대지면적"},"floor_area":{"type":"number","format":"double","description":"건물통합건축면적"},"bulding_coverage_ratio":{"type":"number","format":"double","description":"건물통합_건폐율"},"gross_floor_area":{"type":"number","format":"double","description":"건물통합_연면적"},"floor_area_ratio":{"type":"number","format":"double","description":"건물통합_용적율"},"structure_code":{"type":"string","description":"구조코드"},"structure":{"type":"string","description":"구조코드명"},"structure_etc":{"type":"string","description":"기타구조코드"},"use_code":{"type":"string","description":"주용도코드"},"use":{"type":"string","description":"주용도코드명"},"use_etc":{"type":"string","description":"기타용도"},"roof_code":{"type":"string","description":"지붕코드"},"roof":{"type":"string","description":"지붕코드명"},"roof_etc":{"type":"string","description":"기타지붕"},"height":{"type":"number","format":"double","description":"건물통합_높이"},"floor_ground":{"type":"integer","format":"int32","description":"건물통합_지상층수"},"floor_under":{"type":"integer","format":"int32","description":"건물통합_지하층수"},"approval_date":{"type":"string","description":"승인일자"},"approval_year":{"type":"string","description":"승인년도"},"longitude":{"type":"number","format":"double","description":"경위도X좌표"},"latitude":{"type":"number","format":"double","description":"경위도Y좌표"}}},"buildings":{"description":"건축물 프로파일 목록","type":"array","items":{"$ref":"#/components/schemas/building"}},"bridge":{"description":"교량 프로파일","type":"object","properties":{"id":{"type":"string","description":"시설물 ID"},"owner":{"type":"string","description":"관리기관"},"name":{"type":"string","description":"시설물명"},"category":{"type":"string","description":"시설물 구분"},"kind":{"type":"string","description":"시설물 종류"},"type":{"type":"string","description":"종별"},"latest_diagn":{"type":"string","description":"최근 점검진단일"},"next_diagn":{"type":"string","description":"차기 점검진단일"},"safety_grade":{"type":"string","description":"안전등급"},"addr":{"type":"string","description":"시설물 위치"},"structure":{"type":"string","description":"형식"},"length":{"type":"number","description":"연장"},"lane_count":{"type":"number","description":"차로수"},"span_quantity":{"type":"number","description":"경간수"},"max_span_distance":{"type":"number","description":"최대경간장"}}},"bridges":{"description":"교량 프로파일 목록","type":"array","items":{"$ref":"#/components/schemas/bridge"}},"class3":{"description":"3종 시설물 정보","type":"object","properties":{"id":{"type":"string","description":"시설물 ID"},"name":{"type":"string","description":"시설물명"},"kind":{"type":"string","description":"시설물종류"},"addr":{"type":"string","description":"소재지"},"designation_date":{"type":"string","description":"지정일자"},"owner":{"type":"string","description":"관리주체"},"designated_organization":{"type":"string","description":"지정기관"}}},"cost-anal-factor":{"description":"건축물 유지보수 및 비용분석","type":"object","properties":{"facility_id":{"type":"string","description":"시설물 ID"},"facility_name":{"type":"string","description":"시설물명"},"diagn_period":{"type":"string","description":"점검기간"},"diagn_cooperation":{"type":"string","description":"점검진단기관"},"facility_category":{"type":"string","description":"시설물 구분"},"facility_kind":{"type":"string","description":"시설물종류"},"facility_type":{"type":"string","description":"종별"},"complete_date":{"type":"string","description":"준공일"},"safety_grade":{"type":"string","description":"안전등급"},"addr":{"type":"string","description":"시설물위치"},"significant_deficiency":{"type":"string","description":"중대결함"},"diagn_content":{"type":"string","description":"점검주요결과"},"amend_content":{"type":"string","description":"주요보수보강안"},"write_date":{"type":"string","description":"작성일자"},"amend_idx":{"type":"string","description":"보수보강순번"},"amend_budget":{"type":"string","description":"보수보강예산"},"amend_cost":{"type":"string","description":"보수보강공사비"}}},"cost-anal":{"description":"비용 분석 결과","type":"object","properties":{"facility_id":{"type":"string","description":"시설물 ID"},"diagn_cost":{"type":"number","description":"점검진단 비용"},"amend_cost":{"type":"number","description":"보수보강 비용"}}},"old-anal-factor":{"description":"노후도 분석 인자","type":"object","properties":{"facility_id":{"type":"string","description":"시설물 ID"},"floor_slab/gradient":{"type":"number","description":"바닥판/기울기"},"floor_slab/carbonation":{"type":"number","description":"바닥판/콘크리트 탄산화"},"floor_slab/crack":{"type":"number","description":"바닥판 균열"},"abutment_pier/gradient":{"type":"number","description":"교대_교각/기울기"},"abutment_pier/carbonation":{"type":"number","description":"교대_교각/콘크리트 탄산화"},"abutment_pier/crack":{"type":"number","description":"교대_교각/균열"},"footing/gradient":{"type":"number","description":"기초/기울기"},"footing/carbonation":{"type":"number","description":"기초/콘크리트 탄산화"},"footing/crack":{"type":"number","description":"기초/균열"},"bearing/strain":{"type":"number","description":"교량받침/진단변형량"},"joint/moving":{"type":"number","description":"신축이음장치/이동량"}}},"old-anal":{"description":"노후도 분석 결과","type":"object","properties":{"fcility_id":{"type":"string","description":"시설물 ID"},"floor_slab/average":{"type":"number","description":"바닥판/평균노후도"},"floor_slab/weight":{"type":"number","description":"바닥판/가중치"},"floor_slab/complex":{"type":"number","description":"바닥판/종합노후도"},"abutment_pier/average":{"type":"number","description":"교대_교각/평균노후도"},"abutment_pier/weight":{"type":"number","description":"교대_교각/가중치"},"abutment_pier/complex":{"type":"number","description":"교대_교각/종합노후도"},"footing/average":{"type":"number","description":"기초/평균노후도"},"footing/weight":{"type":"number","description":"기초/가중치"},"footing/complex":{"type":"number","description":"기초/종합노후도"},"others/average":{"type":"number","description":"기타부재/평균노후도"},"others/weight":{"type":"number","description":"기타부재/가중치"},"others/complex":{"type":"number","description":"기타부재/종합노후도"},"facility_decrepit_leve":{"type":"number","description":"시설물 종합 노후도"},"report_date":{"type":"string","description":"분석일자"}}},"risk-anal-factor":{"description":"위험도 분석 인자","type":"object","properties":{"fcility_id":{"type":"string","description":"시설물 ID"},"accelerometer":{"type":"number","description":"지진가속도"},"strain":{"type":"number","description":"변형률"},"wind":{"type":"string","description":"풍속,풍향"},"visibility":{"type":"number","description":"시정거리"},"rainfall":{"type":"number","description":"강우량"},"snowfall":{"type":"number","description":"강우설량"},"temperature":{"type":"number","description":"적외선표면,온도"},"humidity":{"type":"number","description":"습도계"},"years":{"type":"number","description":"공연연수"},"design_live_load":{"type":"string","description":"설계하중"},"annual_average_daily_traffic":{"type":"number","description":"연평균 일교통량"},"defect":{"type":"string","description":"심각한 결함"},"design_live_load_changed":{"type":"string","description":"설계하중 변경"},"collision":{"type":"string","description":"충돌"},"design_book":{"type":"string","description":"설계도서"},"maintenance_documents":{"type":"string","description":"유지관리 문서"},"snow_removal_meterial":{"type":"string","description":"재설재료"},"distance_from_coast":{"type":"string","description":"해안으로부터의 거리"},"road_type":{"type":"string","description":"도로형태"},"bridge_width":{"type":"string","description":"교량의 폭"},"undeger_ground_facility":{"type":"string","description":"하부 시설물"},"lifeline":{"type":"string","description":"라이프라인"},"bypass":{"type":"number","description":"우회도"},"complaint":{"type":"number","description":"민원사항"},"maintenance_facility":{"type":"string","description":"유지관리 시설"}}},"risk-anal":{"description":"위험도 분석 결과","type":"object","properties":{"fcility_id":{"type":"string","description":"시설물 ID"},"safety_fragility/years":{"type":"number","description":"안전취약도/공용년수"},"safety_fragility/design_live_load":{"type":"number","description":"안전취약도/설계하중"},"safety_fragility/annual_average_daily_traffic":{"type":"number","description":"안전취약도/연평균 일교통량"},"safety_fragility/defect":{"type":"number","description":"안전취약도/심각한 결함"},"safety_fragility/design_live_load_changed":{"type":"number","description":"안전취약도/설계하중 변경"},"safety_fragility/collision":{"type":"number","description":"안전취약도/충돌"},"safety_fragility/design_book":{"type":"number","description":"안전취약도/설계도서"},"safety_fragility/maintenance_docs":{"type":"number","description":"안전취약도/유지 관리 문서"},"disaster_fragility/accelerometer":{"type":"number","description":"재해취약도/지진가속도"},"disaster_fragility/wind":{"type":"number","description":"재해취약도/풍속"},"disaster_fragility/visibility":{"type":"number","description":"재해취약도/시정거리"},"fragility_weight":{"type":"number","description":"취약도가중치"},"social_effects/snow_removal_meterial":{"type":"number","description":"사회적영향도/제설재료"},"social_effects/distance_from_coast":{"type":"number","description":"사회적영향도/해안으로부터의 거리"},"social_effects/road_type":{"type":"number","description":"사회적영향도/도로형태"},"social_effects/bridge_width":{"type":"number","description":"사회적영향도/교량폭"},"social_effects/undeger_ground_facility":{"type":"number","description":"사회적영향도/하부 시설물"},"social_effects/lifeline":{"type":"number","description":"사회적영향도/라이프라인"},"social_effects/bypass":{"type":"number","description":"사회적영향도/우회도"},"social_effects/complaint":{"type":"number","description":"사회적영향도/민원사항"},"social_effects/maintenance_facility":{"type":"number","description":"사회적영향도/유지관리 시설"},"social_effects_weight":{"type":"number","description":"사회적영향도가중치"},"hazard_quotient":{"type":"number","description":"위험도지수"},"report_date":{"type":"string","description":"분석일자"}}},"sensor":{"description":"센서 프로파일","type":"object","properties":{"sensor_id":{"type":"string","description":"센서 ID"},"facility_id":{"type":"string","description":"시설물 ID"},"longitude":{"type":"number","description":"센서위치_경도"},"latitude":{"type":"number","description":"센서위치_위도"},"unit":{"type":"string","description":"센싱단위"},"period":{"type":"string","description":"센싱주기"}}},"sensors":{"description":"센서 프로파일 목록","type":"array","items":{"$ref":"#/components/schemas/sensor"}},"sensor-status":{"description":"센서 상태","type":"object","properties":{"sensor_id":{"type":"string","description":"센서 ID"},"status":{"type":"string","description":"상태정보"}}},"sensor-data":{"description":"센서 데이터","type":"object","properties":{"sensor_id":{"type":"string","description":"센서 ID"},"timestamp":{"type":"string","description":"관측시각"},"value":{"type":"integer","description":"값"}}},"sensor-data-list":{"description":"센서 데이터 목록","type":"array","items":{"$ref":"#/components/schemas/sensor-data"}}}},"tags":[{"name":"시설물 프로파일"},{"name":"시설물 비용 분석"},{"name":"시설물 노후도 분석"},{"name":"시설물 위험도 분석"},{"name":"센서 프로파일"},{"name":"센서 상태"},{"name":"센서 데이터"}],"paths":{"/facility/buildings":{"get":{"tags":["시설물 프로파일"],"summary":"건축물 프로파일 조회","parameters":[{"name":"id","in":"query","description":"시설물 ID","schema":{"type":"string"}},{"name":"building_name","in":"query","description":"건물명칭","schema":{"type":"string"}},{"name":"addr","in":"query","description":"시설물 주소","schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/buildings"}}}},"400":{"description":"Bad request"},"401":{"description":"Unauthorized"},"404":{"description":"Not found"}}}},"/facility/bridges":{"get":{"tags":["시설물 프로파일"],"summary":"교량 프로파일 조회","parameters":[{"name":"id","in":"query","description":"시설물 ID","schema":{"type":"string"}},{"name":"name","in":"query","description":"시설물명","schema":{"type":"string"}},{"name":"addr","in":"query","description":"시설물 주소","schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/bridges"}}}},"400":{"description":"Bad request"},"401":{"description":"Unauthorized"},"404":{"description":"Not found"}}}},"/facility/class3":{"get":{"tags":["시설물 프로파일"],"summary":"3종 시설물 조회","parameters":[{"name":"id","in":"query","description":"시설물 ID","schema":{"type":"string"}},{"name":"name","in":"query","description":"시설물명","schema":{"type":"string"}},{"name":"addr","in":"query","description":"시설물 주소","schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/class3"}}}},"400":{"description":"Bad request"},"401":{"description":"Unauthorized"},"404":{"description":"Not found"}}}},"/facility/cost-anal-factor":{"get":{"tags":["시설물 비용 분석"],"summary":"비용분석을 위한 요소 조회","parameters":[{"name":"facility_id","in":"query","description":"시설물 ID","schema":{"type":"string"}},{"name":"facility_name","in":"query","description":"시설물명","schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/cost-anal-factor"}}}},"400":{"description":"Bad request"},"401":{"description":"Unauthorized"},"404":{"description":"Not found"}}}},"/facility/cost-anal":{"post":{"tags":["시설물 비용 분석"],"summary":"비용 분석 결과 입력","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/cost-anal"}}}},"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/cost-anal"}}}},"400":{"description":"Bad request"},"401":{"description":"Unauthorized"},"404":{"description":"Not found"}}},"get":{"tags":["시설물 비용 분석"],"summary":"비용 분석 결과 조회","parameters":[{"name":"facility_id","in":"query","description":"시설물 ID","schema":{"type":"string"}},{"name":"facility_name","in":"query","description":"시설물명","schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/cost-anal"}}}},"400":{"description":"Bad request"},"401":{"description":"Unauthorized"},"404":{"description":"Not found"}}}},"/facility/old-anal-factor":{"get":{"tags":["시설물 노후도 분석"],"summary":"노후도을 위한 인자 조회","parameters":[{"name":"facility_id","in":"query","description":"시설물 ID","schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/old-anal-factor"}}}},"400":{"description":"Bad request"},"401":{"description":"Unauthorized"},"404":{"description":"Not found"}}}},"/facility/old-anal":{"post":{"tags":["시설물 노후도 분석"],"summary":"노후도 분석 결과 입력","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/old-anal"}}}},"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/old-anal"}}}},"400":{"description":"Bad request"},"401":{"description":"Unauthorized"},"404":{"description":"Not found"}}},"get":{"tags":["시설물 노후도 분석"],"summary":"노후도 분석 결과 조회","parameters":[{"name":"facility_id","in":"query","description":"시설물 ID","schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/old-anal"}}}},"400":{"description":"Bad request"},"401":{"description":"Unauthorized"},"404":{"description":"Not found"}}}},"/facility/risk-anal-factor":{"get":{"tags":["시설물 위험도 분석"],"summary":"위험도 분석을 위한 인자 조회","parameters":[{"name":"facility_id","in":"query","description":"시설물 ID","schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/risk-anal-factor"}}}},"400":{"description":"Bad request"},"401":{"description":"Unauthorized"},"404":{"description":"Not found"}}}},"/facility/risk-anal":{"post":{"tags":["시설물 위험도 분석"],"summary":"위험도 분석 결과 입력","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/risk-anal"}}}},"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/risk-anal"}}}},"400":{"description":"Bad request"},"401":{"description":"Unauthorized"},"404":{"description":"Not found"}}},"get":{"tags":["시설물 위험도 분석"],"summary":"위험도 분석 결과 조회","parameters":[{"name":"facility_id","in":"query","description":"시설물 ID","schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/risk-anal"}}}},"400":{"description":"Bad request"},"401":{"description":"Unauthorized"},"404":{"description":"Not found"}}}},"/sensor":{"post":{"tags":["센서 프로파일"],"summary":"센서 프로파일 추가","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/sensor"}}}},"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/sensor"}}}},"400":{"description":"Bad request"},"401":{"description":"Unauthorized"},"404":{"description":"Not found"}}},"get":{"tags":["센서 프로파일"],"summary":"센서 프로파일 조회","parameters":[{"name":"sensor_id","in":"query","description":"센서 ID","schema":{"type":"string"}},{"name":"facility_id","in":"query","description":"시설물 ID","schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/sensors"}}}},"400":{"description":"Bad request"},"401":{"description":"Unauthorized"},"404":{"description":"Not found"}}}},"/sensor/{sensor_id}":{"get":{"tags":["센서 프로파일"],"summary":"센서 프로파일 조회","parameters":[{"name":"sensor_id","in":"path","required":true,"description":"센서 ID","schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/sensor"}}}},"400":{"description":"Bad request"},"401":{"description":"Unauthorized"},"404":{"description":"Not found"}}},"put":{"tags":["센서 프로파일"],"summary":"센서 프로파일 수정","parameters":[{"name":"sensor_id","in":"path","required":true,"description":"센서 ID","schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/sensor"}}}},"responses":{"200":{"description":"Updated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/sensor"}}}},"400":{"description":"Bad request"},"401":{"description":"Unauthorized"},"404":{"description":"Not found"}}},"delete":{"tags":["센서 프로파일"],"summary":"센서 프로파일 삭제","parameters":[{"name":"sensor_id","in":"path","required":true,"description":"센서 ID","schema":{"type":"string"}}],"responses":{"204":{"description":"Deleted"},"400":{"description":"Bad request"},"401":{"description":"Unauthorized"},"404":{"description":"Not found"}}}},"/sensor/status/{sensor_id}":{"post":{"tags":["센서 상태"],"summary":"센서 상태 입력","parameters":[{"name":"sensor_id","in":"path","required":true,"description":"센서 ID","schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/sensor-status"}}}},"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/sensor-status"}}}},"400":{"description":"Bad request"},"401":{"description":"Unauthorized"},"404":{"description":"Not found"}}}},"/sensor/data/{sensor_id}":{"post":{"tags":["센서 데이터"],"summary":"센서 데이터 입력","parameters":[{"name":"sensor_id","in":"path","required":true,"description":"센서 ID","schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/sensor-data"}}}},"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/sensor-data"}}}},"400":{"description":"Bad request"},"401":{"description":"Unauthorized"},"404":{"description":"Not found"}}}},"/sensor/data":{"get":{"tags":["센서 데이터"],"summary":"센서 데이터 조회","parameters":[{"name":"sensor_id","in":"query","required":true,"description":"센서 ID","schema":{"type":"string"}},{"name":"start_date","in":"query","description":"검색 시작 일자","schema":{"type":"string"}},{"name":"end_date","in":"query","description":"검색 마지막 일자","schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/sensor-data-list"}}}},"400":{"description":"Bad request"},"401":{"description":"Unauthorized"},"404":{"description":"Not found"}}}}}}