맞춤형 API 상세

전국 중고서점 및 운영정보

  • URL

    http://api.kcisa.kr/API_CNV_045/request

  • 설명

    전국의 중고서점 시설 위치정보와 상세 운영정보(화장실 여부, 운영시간, 전화번호, 서점 구분, 네이버 리뷰 여부 등)를 제공합니다.

  • 기관명

    한국문화정보원

    갱신주기

    연간

  • 서비스 분야/주체

    API유형

    REST

  • 등록일

    Jan 13, 2022

    활용도

    69

  • 데이터갱신일

    2021-12-30

오픈 API

요청인자

요청인자 상세표
변수명 타입 변수설명 필수여부
serviceKey string 서비스키 true
numOfRows string 세션당 요청레코드수 false
pageNo string 페이지수 false

출력 값

출력 값 상세표
No 변수명 출력설명
1 ESNTL_ID 고유ID
2 FCLTY_NM 시설명
3 LCLAS_NM 대분류명
4 MLSFC_NM 중분류명
5 ZIP_NO 우편번호
6 FCLTY_ROAD_NM_ADDR 시설도로명주소
7 FCLTY_LA 시설위도
8 FCLTY_LO 시설경도
9 WORKDAY_OPN_BSNS_TIME 평일개점시간
10 WORKDAY_CLOS_TIME 평일마감시간
11 SAT_OPN_BSNS_TIME 토요일개점시간
12 SAT_CLOS_TIME 토요일마감시간
13 SUN_OPN_BSNS_TIME 일요일개점시간
14 SUN_CLOS_TIME 일요일마감시간
15 RSTDE_OPN_BSNS_TIME 휴무일개점시간
16 RSTDE_CLOS_TIME 휴무일마감시간
17 RSTDE_GUID_CN 휴무일안내내용
18 TEL_NO 전화번호
19 OPTN_DC 옵션설명
20 ADIT_DC 추가설명

메시지 설명

메시지 설명 상세표
0000 정상 처리
F2013 서비스 주소 호출 실패
9999 서비스 점검중(내부 서비스 호출 장애)

활용 명세

샘플 데이터

>샘플 데이터 상세

샘플코드

/* Java Sample */
import java.io.InputStreamReader;
import java.net.HttpURLConnection;
import java.net.URL;
import java.net.URLEncoder;
import java.io.BufferedReader;
import java.io.IOException;

public class openApi {
public static void main(String[] args) throws IOException {

StringBuilder urlBuilder = new StringBuilder("http://api.kcisa.kr/API_CNV_045/request"); /*URL*/
urlBuilder.append("?" + URLEncoder.encode("serviceKey","UTF-8") + "=서비스키"); /*서비스키*/
urlBuilder.append("&" + URLEncoder.encode("numOfRows","UTF-8") + "=" + URLEncoder.encode("세션당 요청레코드수", "UTF-8")); /*세션당 요청레코드수*/
urlBuilder.append("&" + URLEncoder.encode("pageNo","UTF-8") + "=" + URLEncoder.encode("페이지수", "UTF-8")); /*페이지수*/

URL url = new URL(urlBuilder.toString());
HttpURLConnection conn = (HttpURLConnection) url.openConnection();

conn.setRequestMethod("GET");
conn.setRequestProperty("Content-type", "application/json");
System.out.println("Response code: " + conn.getResponseCode());

BufferedReader rd;
if(conn.getResponseCode() >= 200 && conn.getResponseCode() <= 300) {

rd = new BufferedReader(new InputStreamReader(conn.getInputStream()));

} else {

rd = new BufferedReader(new InputStreamReader(conn.getErrorStream()));

}

StringBuilder sb = new StringBuilder();
String line;
while ((line = rd.readLine()) != null) {

sb.append(line);

}
rd.close();
conn.disconnect();
System.out.println(sb.toString());

}

}
/* Javascript Sample*/
var xhr = new XMLHttpRequest();
var url = 'http://api.kcisa.kr/API_CNV_045/request'; /*URL*/
var queryParams = '?' + encodeURIComponent('serviceKey') + '=' + '서비스키'; /*서비스키*/
queryParams += '&' + encodeURIComponent('numOfRows') + '=' + encodeURIComponent('세션당 요청레코드수'); /*세션당 요청레코드수*/
queryParams += '&' + encodeURIComponent('pageNo') + '=' + encodeURIComponent('페이지수'); /*페이지수*/

xhr.open('GET', url + queryParams);
xhr.onreadystatechange = function () {
if (this.readyState == 4) {

console.log('status: ' + this.status);
console.log('resultCode: ' + $(this.responseText).find('resultCode').text());
console.log('resultMsg: ' + $(this.responseText).find('resultMsg').text());

var item = $(this.responseText).find('item');
$(item).each(function(){

console.log("ESNTL_ID" + $(this).find("ESNTL_ID").text());
console.log("FCLTY_NM" + $(this).find("FCLTY_NM").text());
console.log("LCLAS_NM" + $(this).find("LCLAS_NM").text());
console.log("MLSFC_NM" + $(this).find("MLSFC_NM").text());
console.log("ZIP_NO" + $(this).find("ZIP_NO").text());
console.log("FCLTY_ROAD_NM_ADDR" + $(this).find("FCLTY_ROAD_NM_ADDR").text());
console.log("FCLTY_LA" + $(this).find("FCLTY_LA").text());
console.log("FCLTY_LO" + $(this).find("FCLTY_LO").text());
console.log("WORKDAY_OPN_BSNS_TIME" + $(this).find("WORKDAY_OPN_BSNS_TIME").text());
console.log("WORKDAY_CLOS_TIME" + $(this).find("WORKDAY_CLOS_TIME").text());
console.log("SAT_OPN_BSNS_TIME" + $(this).find("SAT_OPN_BSNS_TIME").text());
console.log("SAT_CLOS_TIME" + $(this).find("SAT_CLOS_TIME").text());
console.log("SUN_OPN_BSNS_TIME" + $(this).find("SUN_OPN_BSNS_TIME").text());
console.log("SUN_CLOS_TIME" + $(this).find("SUN_CLOS_TIME").text());
console.log("RSTDE_OPN_BSNS_TIME" + $(this).find("RSTDE_OPN_BSNS_TIME").text());
console.log("RSTDE_CLOS_TIME" + $(this).find("RSTDE_CLOS_TIME").text());
console.log("RSTDE_GUID_CN" + $(this).find("RSTDE_GUID_CN").text());
console.log("TEL_NO" + $(this).find("TEL_NO").text());
console.log("OPTN_DC" + $(this).find("OPTN_DC").text());
console.log("ADIT_DC" + $(this).find("ADIT_DC").text());

});

};

}
xhr.send('');