pis-api-server/api-docs.json

{
  "swagger": "2.0",
  "info": {
    "description": "PIS Park Open API Service",
    "version": "0.0.1",
    "title": "Intelligent Traffic Service"
  },
  "host": "115.91.94.42:9000",
  "basePath": "/",
  "tags": [
    {
      "name": "주차정보 시스템 정보제공",
      "description": "Tb Prk Plce Controller"
    }
  ],
  "paths": {
    "/api/park/dev": {
      "get": {
        "tags": [
          "주차정보 시스템 정보제공"
        ],
        "summary": "5.주차장 수집장치 정보 전체조회",
        "operationId": "findAllDevListUsingGET",
        "produces": [
          "application/json;charset=utf8"
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/TbPrkPlceDevDto(주차정보 수집장치 정보)"
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false
      }
    },
    "/api/park/dev/rt": {
      "get": {
        "tags": [
          "주차정보 시스템 정보제공"
        ],
        "summary": "7.주차장 수집장치 실시간정보 전체조회",
        "operationId": "findAllDevRtListUsingGET",
        "produces": [
          "application/json;charset=utf8"
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/TbPrkPlceDevDto(주차정보 수집장치 정보)"
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false
      }
    },
    "/api/park/dev/rt/{prkPlceManageNo}": {
      "get": {
        "tags": [
          "주차정보 시스템 정보제공"
        ],
        "summary": "8.주차장 수집장치 실시간정보 개별조회",
        "operationId": "findDevRtByManageNoUsingGET",
        "produces": [
          "application/json;charset=utf8"
        ],
        "parameters": [
          {
            "name": "prkPlceManageNo",
            "in": "path",
            "description": "주차장관리 ID",
            "required": true,
            "type": "string",
            "x-example": "3551000001"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/TbPrkPlceDevDto(주차정보 수집장치 정보)"
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false
      }
    },
    "/api/park/dev/{prkPlceManageNo}": {
      "get": {
        "tags": [
          "주차정보 시스템 정보제공"
        ],
        "summary": "6.주차장 수집장치 정보 개별조회",
        "operationId": "findDevByManageNoUsingGET",
        "produces": [
          "application/json;charset=utf8"
        ],
        "parameters": [
          {
            "name": "prkPlceManageNo",
            "in": "path",
            "description": "주차장관리 ID",
            "required": true,
            "type": "string",
            "x-example": "3551000001"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/TbPrkPlceDevDto(주차정보 수집장치 정보)"
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false
      }
    },
    "/api/park/plce": {
      "get": {
        "tags": [
          "주차정보 시스템 정보제공"
        ],
        "summary": "1.주차장 시설 정보 전체조회",
        "operationId": "findAllListUsingGET",
        "produces": [
          "application/json;charset=utf8"
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/TbPrkPlceDto(주차장 시설 정보)"
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false
      }
    },
    "/api/park/plce/{prkPlceManageNo}": {
      "get": {
        "tags": [
          "주차정보 시스템 정보제공"
        ],
        "summary": "2.주차장 시설 정보 개별조회",
        "operationId": "findByManageNoUsingGET",
        "produces": [
          "application/json;charset=utf8"
        ],
        "parameters": [
          {
            "name": "prkPlceManageNo",
            "in": "path",
            "description": "주차장관리 ID",
            "required": true,
            "type": "string",
            "x-example": "3551000001"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/TbPrkPlceDto(주차장 시설 정보)"
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false
      }
    },
    "/api/park/rt": {
      "get": {
        "tags": [
          "주차정보 시스템 정보제공"
        ],
        "summary": "3.주차장 실시간 정보 전체조회",
        "operationId": "findAllRtListUsingGET",
        "produces": [
          "application/json;charset=utf8"
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/TbPrkPlceRtDto(주차장 실시간 정보)"
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false
      }
    },
    "/api/park/rt/{prkPlceManageNo}": {
      "get": {
        "tags": [
          "주차정보 시스템 정보제공"
        ],
        "summary": "4.주차장 실시간 정보 개별조회",
        "operationId": "findRtByManageNoUsingGET",
        "produces": [
          "application/json;charset=utf8"
        ],
        "parameters": [
          {
            "name": "prkPlceManageNo",
            "in": "path",
            "description": "주차장관리 ID",
            "required": true,
            "type": "string",
            "x-example": "3551000001"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "schema": {
              "$ref": "#/definitions/TbPrkPlceRtDto(주차장 실시간 정보)"
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "deprecated": false
      }
    }
  },
  "definitions": {
    "TbPrkPlceDevDto(주차정보 수집장치 정보)": {
      "type": "object",
      "properties": {
        "comm_stts_cd": {
          "type": "string",
          "description": "통신상태태코드(0:점검중,1:정상"
        },
        "comm_stts_desc": {
          "type": "string",
          "description": "통신상태코드설명"
        },
        "data_colct_time": {
          "type": "string",
          "description": "실시간 주차데이터 수집시간 (YYYYMMDDHH24MISS)"
        },
        "devices": {
          "type": "array",
          "description": "주차정보수집장치 목록",
          "items": {
            "$ref": "#/definitions/TbPrkPlceFlrDevDto(주차장 층별 수집장치 정보)"
          }
        },
        "prk_plce_manage_no": {
          "type": "string",
          "description": "주차장 관리 ID"
        }
      },
      "title": "TbPrkPlceDevDto(주차정보 수집장치 정보)"
    },
    "TbPrkPlceDto(주차장 시설 정보)": {
      "type": "object",
      "properties": {
        "ar_level_se": {
          "type": "integer",
          "format": "int32",
          "description": "급지구분(0 : 1급지, 1 : 2급지, 2 : 3급지, 3 : 4급지, 4 : 5급지, 9 : 기타)"
        },
        "crm_prv_cctv_instl_at": {
          "type": "integer",
          "format": "int32",
          "description": "방범 CCTV 설치여부 정보 - 방범 CCTV 설치여부 (0 : 미설치, 1 : 설치)"
        },
        "crm_prv_cctv_instl_co": {
          "type": "integer",
          "format": "int32",
          "description": "방범 CCTV 설치여부 정보 - 방범 CCTV 설치대수"
        },
        "floors": {
          "type": "array",
          "description": "층정보 목록",
          "items": {
            "$ref": "#/definitions/TbPrkPlceFlrDto(주차장 시설 정보-층 정보)"
          }
        },
        "parking_ty": {
          "type": "integer",
          "format": "int32",
          "description": "주차형식(0 : 평행주차, 1 : 직각주차, 2 : 60도 대향주차, 3 : 45도 대향주차, 9 : 기타)"
        },
        "parking_us": {
          "type": "integer",
          "format": "int32",
          "description": "이용형태(0 : 자주식, 1 : 기계식, 9 : 기타)"
        },
        "prk_avail_cartype": {
          "type": "string",
          "description": "이용가능 차량유형 - 아래 유형 조합해서 생성됌 - 예시) 승용(중형), SUV 이용가능 시, (0101000) 0: 승용(소형), 1: 승용(중형), 2: 승용(대형), 3: SUV, 4: 승합차, 5: 화물(중형), 6: 화물(대형) "
        },
        "prk_cmprt_co": {
          "type": "integer",
          "format": "int32",
          "description": "주차장 주차구획 - 총 주차구획 수, 주차장의 총 주차 구획 수"
        },
        "prk_plce_adres": {
          "type": "string",
          "description": "도로명 주소"
        },
        "prk_plce_entrc_extty": {
          "type": "integer",
          "format": "int32",
          "description": "주차장 입출구 형태(0 : 공통출입구, 1 : 출입구 분리, 9 : 기타)"
        },
        "prk_plce_entrc_la": {
          "type": "string",
          "description": "주차장 입구위치 (주출입구 기준) - 주차장 입구위치 위도(35.879337)"
        },
        "prk_plce_entrc_lo": {
          "type": "string",
          "description": "주차장 입구위치 (주출입구 기준) - 주차장 입구위치 경도(128.628764)"
        },
        "prk_plce_entrc_nm": {
          "type": "string",
          "description": "주차장 입구위치 (주출입구 기준) - 주차장 입구명"
        },
        "prk_plce_manage_no": {
          "type": "string",
          "description": "주차장 관리 ID"
        },
        "prk_plce_nm": {
          "type": "string",
          "description": "주차장 이름"
        },
        "vhcty_ar_se0": {
          "type": "integer",
          "format": "int32",
          "description": "주차장 주차구획 - 경차 전용"
        },
        "vhcty_ar_se1": {
          "type": "integer",
          "format": "int32",
          "description": "주차장 주차구획 - 친환경차 (전기차) 전용"
        },
        "vhcty_ar_se2": {
          "type": "integer",
          "format": "int32",
          "description": "주차장 주차구획 - 화물차 전용"
        },
        "vhcty_ar_se3": {
          "type": "integer",
          "format": "int32",
          "description": "주차장 주차구획 - 긴급차량 전용"
        },
        "vhcty_ar_se4": {
          "type": "integer",
          "format": "int32",
          "description": "주차장 주차구획 - 장애인 전용"
        },
        "vhcty_ar_se5": {
          "type": "integer",
          "format": "int32",
          "description": "주차장 주차구획 - 어르신 전용"
        },
        "vhcty_ar_se6": {
          "type": "integer",
          "format": "int32",
          "description": "주차장 주차구획 - 여성 전용"
        },
        "vhcty_ar_se9": {
          "type": "integer",
          "format": "int32",
          "description": "주차장 주차구획 - 기타"
        }
      },
      "title": "TbPrkPlceDto(주차장 시설 정보)"
    },
    "TbPrkPlceFlrDevDto(주차장 층별 수집장치 정보)": {
      "type": "object",
      "properties": {
        "device_id": {
          "type": "string",
          "description": "주차정보수집장치 ID"
        },
        "flr_no": {
          "type": "string",
          "description": "층 번호"
        }
      },
      "title": "TbPrkPlceFlrDevDto(주차장 층별 수집장치 정보)"
    },
    "TbPrkPlceFlrDevRtDto(주차정보 수집장치 정보)": {
      "type": "object",
      "properties": {
        "connected": {
          "type": "integer",
          "format": "int32",
          "description": "통신상태 (0 : 불량, 1 : 정상)"
        },
        "device_id": {
          "type": "string",
          "description": "주차정보수집장치 ID"
        },
        "device_type": {
          "type": "integer",
          "format": "int32",
          "description": "주차정보수집장치 종류 (0 : 영상식, 1 : 지자기, 2 : 레이더, 3 : 루프, 4 : 초음파, 9 : 기타)"
        },
        "occupation": {
          "type": "integer",
          "format": "int32",
          "description": "주차면 점유여부 (0 : 주차가능 (주차면 비점유), 1 : 주차불가 (주차면 점유))"
        },
        "prk_unit_id": {
          "type": "string",
          "description": "주차면 ID, 층번호+구역일련번호 예시) 1FA01 1층 A구역 01번 주차면"
        },
        "typed_parking_lots": {
          "type": "integer",
          "format": "int32",
          "description": "주차면 유형 (0 : 일반, 1 : 경차 전용, 2 : 대형(화물)전용, 3 : 긴급차량전용, 4 : 장애인 전용, 5 : 여성 전용, 9 : 기타)"
        }
      },
      "title": "TbPrkPlceFlrDevRtDto(주차정보 수집장치 정보)"
    },
    "TbPrkPlceFlrDto(주차장 시설 정보-층 정보)": {
      "type": "object",
      "properties": {
        "flr_no": {
          "type": "string",
          "description": "층 번호"
        },
        "flr_prk_cmprt_co": {
          "type": "integer",
          "format": "int32",
          "description": "층별 주차구획 수, 120(면), 시설정보+ 실시간정보"
        },
        "flr_remndr_prk_cmprt_co": {
          "type": "integer",
          "format": "int32",
          "description": "층별 잔여 주차구획 수, 120(면), 실시간정보"
        }
      },
      "title": "TbPrkPlceFlrDto(주차장 시설 정보-층 정보)"
    },
    "TbPrkPlceRtDto(주차장 실시간 정보)": {
      "type": "object",
      "properties": {
        "comm_stts_cd": {
          "type": "string",
          "description": "통신상태태코드(0:점검중,1:정상"
        },
        "comm_stts_desc": {
          "type": "string",
          "description": "통신상태코드설명"
        },
        "data_colct_time": {
          "type": "string",
          "description": "실시간 주차데이터 수집시간 (YYYYMMDDHH24MISS)"
        },
        "floors": {
          "type": "array",
          "description": "층별 실시간정보 목록",
          "items": {
            "$ref": "#/definitions/TbPrkPlceFlrDto(주차장 시설 정보-층 정보)"
          }
        },
        "parking_cgs_sttus": {
          "type": "integer",
          "format": "int32",
          "description": "주차장 상태 코드 (0: 여유(점유 50% 미만), 1: 보통(점유 70% 미만), 2: 혼잡(점유 90% 미만), 3: 만차(점유 90% 초과)), 9: 알수없음"
        },
        "prk_cmprt_co": {
          "type": "integer",
          "format": "int32",
          "description": "주차장의 총 주차 구획 수, 150 (면)"
        },
        "prk_plce_manage_no": {
          "type": "string",
          "description": "주차장 관리 ID"
        },
        "remndr_prk_cmprt_co": {
          "type": "integer",
          "format": "int32",
          "description": "주차장의 총 잔여 주차 구획 수, 150 (면)"
        },
        "vhcty_ar_remndr_prk_cmprt_co0": {
          "type": "integer",
          "format": "int32",
          "description": "잔여 주차 구획 수 - 경차 전용"
        },
        "vhcty_ar_remndr_prk_cmprt_co1": {
          "type": "integer",
          "format": "int32",
          "description": "잔여 주차 구획 수 - 친환경차 (전기차) 전용"
        },
        "vhcty_ar_remndr_prk_cmprt_co2": {
          "type": "integer",
          "format": "int32",
          "description": "잔여 주차 구획 수 - 화물차 전용"
        },
        "vhcty_ar_remndr_prk_cmprt_co3": {
          "type": "integer",
          "format": "int32",
          "description": "잔여 주차 구획 수 - 긴급차량 전용"
        },
        "vhcty_ar_remndr_prk_cmprt_co4": {
          "type": "integer",
          "format": "int32",
          "description": "잔여 주차 구획 수 - 장애인 전용"
        },
        "vhcty_ar_remndr_prk_cmprt_co5": {
          "type": "integer",
          "format": "int32",
          "description": "잔여 주차 구획 수 - 어르신 전용"
        },
        "vhcty_ar_remndr_prk_cmprt_co6": {
          "type": "integer",
          "format": "int32",
          "description": "잔여 주차 구획 수 - 여성 전용"
        },
        "vhcty_ar_remndr_prk_cmprt_co9": {
          "type": "integer",
          "format": "int32",
          "description": "잔여 주차 구획 수 - 기타"
        }
      },
      "title": "TbPrkPlceRtDto(주차장 실시간 정보)"
    }
  }
}