개발가이드

  • 개발가이드

건축물대장 목록 조회

부동산 건축물대장 목록을 조회합니다.

정보

Method
URL
POST
https://apick.app/rest/get_building_register_list

요청

Header
이름
필수
설명
CL_AUTH_KEY
O
인증키(MD5)
FormData
이름
타입
필수
설명
address
String
O
도로명주소

응답

Body
이름
타입
설명
data
Object
조회 데이터
ic_id
Integer
요청 ID
result
Integer
검색 결과
1: 성공
2: 오류(error 내용 확인)
3: 오류(처리시간 초과)
error
String
오류 내용
("알 수 없는 이유로 실패했습니다." 해당 오류 발생 시 요청 내용과 함께 문의글로 남겨주시기 바랍니다.)
juso
String
선택된 주소
data
Array
{}
Object
건축물명칭
String
건축물명칭
동명칭
String
동명칭
호명칭
String
호명칭
연면적
String
연면적
success
Integer
과금 여부
0: 실패
1: 성공
3: 실패(timeout)
api
Object
API 호출 공통 데이터
success
Boolean
API 서버 정상 응답 여부
cost
Integer
API 호출 요금
ms
Integer
API 응답 시간
pl_id
Integer
API 결제 로그 ID

예시

요청 예시

curl -k -X POST "https://apick.app/rest/get_building_register_list" \
-H "CL_AUTH_KEY: $API_KEY" \
-F "address=서울 금천구 가산디지털2로 101"
응답 예시

{
    "data": {
        "ic_id": 3196360,
        "result": 1,
        "data": [
        {
            "건축물명칭": "한라 원앤원타워",
            "동명칭": "한라 원앤원타워",
            "호명칭": "201-1",
            "연면적": "65.51㎡"
        },
        {
            "건축물명칭": "한라 원앤원타워",
            "동명칭": "한라 원앤원타워",
            "호명칭": "A301",
            "연면적": "94.16㎡"
        },
        {
            "건축물명칭": "한라 원앤원타워",
            "동명칭": "한라 원앤원타워",
            "호명칭": "A302",
            "연면적": "93.645㎡"
        },
        .
        .
        .
        {
            "건축물명칭": "한라 원앤원타워",
            "동명칭": "한라 원앤원타워",
            "호명칭": "239",
            "연면적": "23.0275㎡"
        },
        {
            "건축물명칭": "한라 원앤원타워",
            "동명칭": "한라 원앤원타워",
            "호명칭": "240",
            "연면적": "23.0275㎡"
        }
        ],
        "success": 1
    },
    "api": {
        "success": true,
        "cost": 60,
        "ms": 14036,
        "pl_id": 20272690
    }
    }
현재 페이지 북마크