맞춤형 API 상세

문화기반시설 통계정보

  • URL

    http://api.kcisa.kr/openapi/service/rest/convergence2018/conver8

  • 설명

    지역별로 문화기반시설 관련 통계정보 - 공연건수, 전시건수 및 내외국인 방문객수 등 - 을 제공하는 서비스
    문화기반시설 통계정보

  • 기관명

    한국문화정보원

    갱신주기

    연간

  • 서비스 분야/주체

    API유형

    REST

  • 등록일

    Dec 28, 2018

    활용도

    3,375

오픈 API

요청인자

요청인자 상세표
변수명 타입 변수설명 필수여부
serviceKey string 서비스키 true
numOfRows string 세션당 요청레코드수 false
pageNo string 페이지수 false
year string 방문연도 false
sido string 시도 false
gungu string 군구 false

출력 값

출력 값 상세표
No 변수명 출력설명
1 destination 집계관광지 수
2 foreignPayVisitor 외국인유료관광지 방문객 수
3 freeVisitor 무료관광지 방문객 수
4 gungu 군구
5 localPayVisitor 내국인 유료관광지 방문객 수
6 rnum 번호
7 sido 시도
8 visitor 방문객 수
9 year 방문연도
10 subject 시각/공연 구분
11 subjectCategory 시각/공연예술 형태
12 subjectKeyword 시각/공연예술 형태 상세
13 prfCnt 전시/공연 건수(건)
14 prfRate 전시/공연 건수 비율(%)
15 prfPeriod 평균 전시 기간(일)
16 prfNum 공연 횟수(회)
17 prfNumRate 공연 횟수 비율(%)

메시지 설명

메시지 설명 상세표
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/openapi/service/rest/convergence2018/conver8"); /*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")); /*페이지수*/
urlBuilder.append("&" + URLEncoder.encode("year","UTF-8") + "=" + URLEncoder.encode("방문연도", "UTF-8")); /*방문연도*/
urlBuilder.append("&" + URLEncoder.encode("sido","UTF-8") + "=" + URLEncoder.encode("시도", "UTF-8")); /*시도*/
urlBuilder.append("&" + URLEncoder.encode("gungu","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/openapi/service/rest/convergence2018/conver8'; /*URL*/
var queryParams = '?' + encodeURIComponent('serviceKey') + '=' + '서비스키'; /*서비스키*/
queryParams += '&' + encodeURIComponent('numOfRows') + '=' + encodeURIComponent('세션당 요청레코드수'); /*세션당 요청레코드수*/
queryParams += '&' + encodeURIComponent('pageNo') + '=' + encodeURIComponent('페이지수'); /*페이지수*/
queryParams += '&' + encodeURIComponent('year') + '=' + encodeURIComponent('방문연도'); /*방문연도*/
queryParams += '&' + encodeURIComponent('sido') + '=' + encodeURIComponent('시도'); /*시도*/
queryParams += '&' + encodeURIComponent('gungu') + '=' + 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("destination" + $(this).find("destination").text());
console.log("foreignPayVisitor" + $(this).find("foreignPayVisitor").text());
console.log("freeVisitor" + $(this).find("freeVisitor").text());
console.log("gungu" + $(this).find("gungu").text());
console.log("localPayVisitor" + $(this).find("localPayVisitor").text());
console.log("rnum" + $(this).find("rnum").text());
console.log("sido" + $(this).find("sido").text());
console.log("visitor" + $(this).find("visitor").text());
console.log("year" + $(this).find("year").text());
console.log("subject" + $(this).find("subject").text());
console.log("subjectCategory" + $(this).find("subjectCategory").text());
console.log("subjectKeyword" + $(this).find("subjectKeyword").text());
console.log("prfCnt" + $(this).find("prfCnt").text());
console.log("prfRate" + $(this).find("prfRate").text());
console.log("prfPeriod" + $(this).find("prfPeriod").text());
console.log("prfNum" + $(this).find("prfNum").text());
console.log("prfNumRate" + $(this).find("prfNumRate").text());

});

};

}
xhr.send('');