맞춤형 API 상세

소소하지만 확실한 여행

  • URL

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

  • 설명

    한국관광공사에서 제공하는 검증된 숙박 시설 정보 및 공공데이터포털에서 제공하는 공중화장실 및 무료와이파이 정보를 제공하는 서비스
    소소하지만 확실한 여행

  • 기관명

    한국문화정보원

    갱신주기

    연간

  • 서비스 분야/주체

    API유형

    REST

  • 등록일

    Dec 28, 2018

    활용도

    3,357

오픈 API

요청인자

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

출력 값

출력 값 상세표
No 변수명 출력설명
1 address 지번 주소
2 address2 도로명 주소
3 category1 서비스대상 구분
4 category2 외국어 안내서비스
5 creator 개체
6 gungu 군구
7 insertDate 수집일
8 lat 위도
9 lon 경도
10 parkingyn 주차장 보유여부
11 publisher 수집기관코드
12 regDate 등록일
13 rnum 번호
14 roomName 업소명
15 sido 시도
16 subject 업종명
17 totalCapacity 객실 수
18 servName 서비스제공사명
19 ssid 와이파이 SSID
20 wInsDate 와이파이 설치년월
21 toiletyn 남녀공용화장실여부
22 cnt1 남성용 소/대변기수
23 cnt2 여성용 소/대변기수
24 time 화장실 개방시간
25 contact 전화번호
26 category3 부대시설
27 category4 결제방법
28 homepage 홈페이지주소
29 category5 주변관광정보
30 sigungu 시군구
31 affiliation 관리기관명
32 tInsDate 화장실 설치년도
33 description 와이파이설치장소상세

메시지 설명

메시지 설명 상세표
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/conver7"); /*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("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/conver7'; /*URL*/
var queryParams = '?' + encodeURIComponent('serviceKey') + '=' + '서비스키'; /*서비스키*/
queryParams += '&' + encodeURIComponent('numOfRows') + '=' + encodeURIComponent('세션당 요청레코드수'); /*세션당 요청레코드수*/
queryParams += '&' + encodeURIComponent('pageNo') + '=' + 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("address" + $(this).find("address").text());
console.log("address2" + $(this).find("address2").text());
console.log("category1" + $(this).find("category1").text());
console.log("category2" + $(this).find("category2").text());
console.log("creator" + $(this).find("creator").text());
console.log("gungu" + $(this).find("gungu").text());
console.log("insertDate" + $(this).find("insertDate").text());
console.log("lat" + $(this).find("lat").text());
console.log("lon" + $(this).find("lon").text());
console.log("parkingyn" + $(this).find("parkingyn").text());
console.log("publisher" + $(this).find("publisher").text());
console.log("regDate" + $(this).find("regDate").text());
console.log("rnum" + $(this).find("rnum").text());
console.log("roomName" + $(this).find("roomName").text());
console.log("sido" + $(this).find("sido").text());
console.log("subject" + $(this).find("subject").text());
console.log("totalCapacity" + $(this).find("totalCapacity").text());
console.log("servName" + $(this).find("servName").text());
console.log("ssid" + $(this).find("ssid").text());
console.log("wInsDate" + $(this).find("wInsDate").text());
console.log("toiletyn" + $(this).find("toiletyn").text());
console.log("cnt1" + $(this).find("cnt1").text());
console.log("cnt2" + $(this).find("cnt2").text());
console.log("time" + $(this).find("time").text());
console.log("contact" + $(this).find("contact").text());
console.log("category3" + $(this).find("category3").text());
console.log("category4" + $(this).find("category4").text());
console.log("homepage" + $(this).find("homepage").text());
console.log("category5" + $(this).find("category5").text());
console.log("sigungu" + $(this).find("sigungu").text());
console.log("affiliation" + $(this).find("affiliation").text());
console.log("tInsDate" + $(this).find("tInsDate").text());
console.log("description" + $(this).find("description").text());

});

};

}
xhr.send('');