개발가이드

  • 개발가이드

토지(임야)대장 목록 조회

부동산 토지(임야)대장 목록을 조회합니다.

정보

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

요청

Header
이름
필수
설명
CL_AUTH_KEY
O
인증키(MD5)
FormData
이름
타입
필수
설명
address
String
O
시군구 읍면동
land_type
String
O
토지 또는 임야
bonbun
String
O
지번 본번
bubun
String
X
지번 부번
gunmul_num
String
X
건물번호

응답

Body
이름
타입
설명
data
Object
조회 데이터
ic_id
Integer
요청 ID
result
Integer
검색 결과
1: 성공
2: 오류(error 내용 확인)
3: 오류(처리시간 초과)
error
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_land_register_list" \
-H "CL_AUTH_KEY: $API_KEY" \
-F "address=구로구 항동" \
-F "land_type=토지" \
-F "bonbun=236" \
-F "gunmul_num=0041"
응답 예시

{
    "data": {
        "ic_id": 3196339,
        "result": 1,
        "data": [
        {
            "동": "101",
            "층": "2",
            "호": "202",
            "실": "0000"
        },
        {
            "동": "101",
            "층": "2",
            "호": "203",
            "실": "0000"
        },
        .
        .
        .
        {
            "동": "106",
            "층": "16",
            "호": "1602",
            "실": "0000"
        },
        {
            "동": "상가1",
            "층": "1",
            "호": "102",
            "실": "0000"
        },
        {
            "동": "상가1",
            "층": "1",
            "호": "103",
            "실": "0000"
        },
        {
            "동": "상가1",
            "층": "1",
            "호": "106",
            "실": "0000"
        },
        {
            "동": "상가1",
            "층": "1",
            "호": "108",
            "실": "0000"
        },
        {
            "동": "상가1",
            "층": "1",
            "호": "110",
            "실": "0000"
        }
        ],
        "success": 1
    },
    "api": {
        "success": true,
        "cost": 60,
        "ms": 15057,
        "pl_id": 20264674
    }
}
현재 페이지 북마크