{"openapi":"3.0.3","info":{"title":"APICK 도로명주소 조회","version":"1.0.0","description":"주소 검색을 통해 도로명 주소를 조회합니다."},"servers":[{"url":"https://apick.app"}],"paths":{"/rest/search_juso":{"post":{"summary":"도로명주소 조회","description":"주소 검색을 통해 도로명 주소를 조회합니다.","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"서비스별 성공·처리 상태 응답","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"result":{"type":"array","items":{"type":"object","properties":{"detBdNmList":{"type":"string","description":"상세건물명"},"engAddr":{"type":"string","description":"도로명주소(영문)"},"rn":{"type":"string","description":"도로명"},"emdNm":{"type":"string","description":"읍면동명"},"zipNo":{"type":"string","description":"우편번호"},"roadAddrPart2":{"type":"string","description":"도로명주소 참고항목"},"emdNo":{"type":"string","description":"읍면동일련번호"},"sggNm":{"type":"string","description":"시군구명"},"jibunAddr":{"type":"string","description":"지번 정보"},"siNm":{"type":"string","description":"시도명"},"roadAddrPart1":{"type":"string","description":"도로명주소(참고항목 제외)"},"bdNm":{"type":"string","description":"건물명"},"admCd":{"type":"string","description":"행정구역코드"},"udrtYn":{"type":"string","description":"지하여부(0: 지상, 1: 지하)"},"lnbrMnnm":{"type":"string","description":"지번본번(번지)"},"roadAddr":{"type":"string","description":"전체 도로명주소"},"lnbrSlno":{"type":"string","description":"지번부번(호) (부번이 없는 경우 0)"},"buldMnnm":{"type":"string","description":"건물본번"},"bdKdcd":{"type":"string","description":"공동주택여부(1: 공동주택, 0: 비공동주택)"},"liNm":{"type":"string","description":"법정리명"},"rnMgtSn":{"type":"string","description":"도로명코드"},"mtYn":{"type":"string","description":"산여부(0: 대지, 1: 산)"},"bdMgtSn":{"type":"string","description":"건물관리번호"},"buldSlno":{"type":"string","description":"건물부번 (부번이 없는 경우 0)"}}},"description":"주소 목록"},"total_count":{"type":"string","description":"전체 검색결과 개수"},"success":{"type":"integer","description":"과금 여부0: 실패1: 성공3: 실패(timeout)"}},"description":"조회 데이터"},"api":{"type":"object","properties":{"success":{"type":"boolean","description":"API 서버 정상 응답 여부"},"cost":{"type":"integer","description":"API 호출 요금"},"ms":{"type":"integer","description":"API 응답 시간"},"pl_id":{"type":"integer","description":"API 결제 로그 ID"}},"description":"API 호출 공통 데이터"}}}}}},"default":{"description":"HTTP 상태 및 서비스 오류코드 확인","content":{"application/json":{"schema":{"type":"object"}}}}},"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"juso":{"type":"string","description":"검색할 주소 키워드 (지번, 도로명. 예: 디지털로) (string)","example":"디지털로"},"page":{"type":"string","description":"검색 결과 조회 페이지 (기본값 1, 페이지당 10건) (string)","example":"1"}},"required":["juso","page"]}}}}}}},"x-code-tables":[],"x-service-errors":[],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}}}