맞춤형 API 상세

어디서 운동할까

  • URL

    http://api.kcisa.kr/openapi/service/rest/convergence2019/getConver09

  • 설명

    생활체육에 대한 수요가 증가함에 따라 체육종목별 대회정보, 운영현황, 공공체육시설의 위치 정보 안내, 올바른 운동법 안내를 위한 동영상 서비스를 제공
    어디서 운동할까

  • 기관명

    국민체육진흥공단,대한체육회

    갱신주기

    연간

  • 서비스 분야/주체

    API유형

    REST

  • 등록일

    Mar 2, 2020

    활용도

    41,727

오픈 API

요청인자

요청인자 상세표
변수명 타입 변수설명 필수여부
serviceKey string 서비스키 true
numOfRows string 세션당 요청레코드수 false
pageNo string 페이지수 false
keyword string 검색어 false
where string 지역 false
category string 검색할 서비스 분류 false

출력 값

출력 값 상세표
No 변수명 출력설명
1 rnum 번호
2 creator 주된 책임을 진 개체
3 publisher 발행기관
4 collectionDb 소속(통제)DB
5 regDate 등록일
6 issuedDate 발행일
7 period 기간
8 title 자원의 명칭
9 medium 자원의물리적(물질적)상태
10 extent 자원의 크기나 재생시간
11 venue 장소
12 description 내용
13 affiliation 소속
14 subDescription 보조 서술
15 spatial 공간
16 relation 관련자원
17 reference 참조한자원
18 rights 자원에 대한 권리
19 source 유래자원에 대한 참조
20 contributor 기여자
21 subjectCategory 기관별주제분류체계
22 grade 등급 정보
23 subjectKeyword 핵심주제어(키워드)
24 state 상태
25 url 지식정보자원위치정보

메시지 설명

메시지 설명 상세표
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/convergence2019/getConver09"); /*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("keyword","UTF-8") + "=" + URLEncoder.encode("검색어", "UTF-8")); /*검색어*/
urlBuilder.append("&" + URLEncoder.encode("where","UTF-8") + "=" + URLEncoder.encode("지역", "UTF-8")); /*지역*/
urlBuilder.append("&" + URLEncoder.encode("category","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/convergence2019/getConver09'; /*URL*/
var queryParams = '?' + encodeURIComponent('serviceKey') + '=' + '서비스키'; /*서비스키*/
queryParams += '&' + encodeURIComponent('numOfRows') + '=' + encodeURIComponent('세션당 요청레코드수'); /*세션당 요청레코드수*/
queryParams += '&' + encodeURIComponent('pageNo') + '=' + encodeURIComponent('페이지수'); /*페이지수*/
queryParams += '&' + encodeURIComponent('keyword') + '=' + encodeURIComponent('검색어'); /*검색어*/
queryParams += '&' + encodeURIComponent('where') + '=' + encodeURIComponent('지역'); /*지역*/
queryParams += '&' + encodeURIComponent('category') + '=' + 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("rnum" + $(this).find("rnum").text());
console.log("creator" + $(this).find("creator").text());
console.log("publisher" + $(this).find("publisher").text());
console.log("collectionDb" + $(this).find("collectionDb").text());
console.log("regDate" + $(this).find("regDate").text());
console.log("issuedDate" + $(this).find("issuedDate").text());
console.log("period" + $(this).find("period").text());
console.log("title" + $(this).find("title").text());
console.log("medium" + $(this).find("medium").text());
console.log("extent" + $(this).find("extent").text());
console.log("venue" + $(this).find("venue").text());
console.log("description" + $(this).find("description").text());
console.log("affiliation" + $(this).find("affiliation").text());
console.log("subDescription" + $(this).find("subDescription").text());
console.log("spatial" + $(this).find("spatial").text());
console.log("relation" + $(this).find("relation").text());
console.log("reference" + $(this).find("reference").text());
console.log("rights" + $(this).find("rights").text());
console.log("source" + $(this).find("source").text());
console.log("contributor" + $(this).find("contributor").text());
console.log("subjectCategory" + $(this).find("subjectCategory").text());
console.log("grade" + $(this).find("grade").text());
console.log("subjectKeyword" + $(this).find("subjectKeyword").text());
console.log("state" + $(this).find("state").text());
console.log("url" + $(this).find("url").text());

});

};

}
xhr.send('');