API 소개

***오픈 API이므로 GET으로 호출할 때 발급 USER_KEY가 필요합니다***

0. API 호출 예제

PHP
// 더더더 주소 이력 검색 Open API 예제
<?php
	$client_key = "YOUR_CLIENT_KEY";			// user key
	$client_compare = "YOUR_CLIENT_COMPARE";	// 찾을 주소
	$client_page = "YOUR_CLIENT_PAGE";		// page number
	
	//$url = "http://www.dddsns.com/php/requestCrackdown.php?key=".$client_key."&compare=".$client_compare; // page number를 받지 않을 경우
	$url = "http://www.dddsns.com/php/requestCrackdown.php?key=".$client_key."&compare=".$client_compare."&sel_page=".$client_page; // page number를 받을 경우
	
	$is_post = false;
	$ch = curl_init();
	curl_setopt($ch, CURLOPT_URL, $url);
	curl_setopt($ch, CURLOPT_POST, $is_post);
	curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

	$headers = array();
	$headers[] = "key: ".$client_key;
	$headers[] = "compare: ".$client_compare;
	
	curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
	curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, 0);
	$response = curl_exec ($ch);
	$status_code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
	
	curl_close ($ch);
	if($status_code == 200) {
		echo $response;
	} else {
		echo "Error 내용:".$response;
	}
?>
		

1. API 기본 정보

메서드 요청 URL 출력 포맷
GET http://www.dddsns.com/php/requestCrackdown.php JSON

2. 요청 변수

요청 변수 타입 필수 여부 설명
key string Y 검색을 하기 위해서는 부여받은 USER KEY가 있어야 한다.
compare string Y 검색을 하기 위해서는 검색하고자 하는 주소가 있어야 한다.
sel_page integer N 검색 결과를 한 페이지 당 15개의 항목만을 보여주므로 페이지 넘버가 필요하다.
* 입력되지 않았을 경우 기본값 : 1

3. 출력 결과

필드 타입 설명
resultCode integer 0: 검색 성공 / 1: 검색 실패
resultMessage string 검색 성공: 공백 / 검색 실패: 실패 이유(4. 에러코드 참고)
resultCount string 검색 결과 총 개수
crack[latitude] double 해당 주소의 정확한 위치를 알기 위한 '위도'를 나타내준다.
crack[longitude] double 해당 주소의 정확한 위치를 알기 위한 '경도'를 나타내준다.
crack[sido] string 해당 주소의 시도를 나타내준다. ex) 경기도, 충청북도, 충청남도, 경상북도 등...
crack[address] string 해당 상세 주소를 나타내준다. ex) 대구광역시 동구 팔공로 227

4. 에러 코드

에러 메시지 조치 방안
key값이 없습니다. 필수 요소인 key의 정보가 입력되지 않았으므로 확인바랍니다.
key값이 일치하지 않습니다. 입력된 key의 정보가 관리 테이블에 없는 key이므로 오타가 있는지 확인바랍니다.
하루 사용량을 초과하셨습니다. 한 개의 key 당 하루 검색 사용량은 10000번입니다. 내일 다시 시도해주세요.
지역이나 주소를 전달받지 못하였습니다. 필수 요소인 주소의 정보가 입력되지 않았으므로 확인바랍니다.
찾고자 하는 주소의 값이 없습니다. 검색하신 주소에 대한 데이터가 존재하지 않습니다.