맞춤형 API 상세

국립국어원 외_외국인을 위한 우리말 배우기

기본정보

URL

http://api.kcisa.kr/openapi/service/rest/convergence2017/conver5
설명

세계인이 누리는 한국어를 올바르게 학습하고 국민의 언어생활의 지침이 될 수 있도록 올바른 우리말 제공. 한국어기초사전과 국립국어원 한국어-외국어 학습사전은 한국어 교육의 기본이 되는 5만 어휘를 담고, 쉬운 뜻풀이, 일상생활에서 자주 쓰는 예문 및 문법과 표현, 삽화, 사진, 동영상, 발음 등과 같은 다중 매체 정보, 관련어 정보를 연결한 한국어 학습용 정보 제공.
제공기관

국립국어원,한국문화정보원
API 키워드
서비스 분류
API유형

REST
API 등록일

2017-12-01

호출건수

3,434
데이터 수정일

2025-04-29

갱신주기

연간

오픈 API

요청인자

서비스키
- 변수명serviceKey
- 타입string
- 필수여부true
세션당 요청레코드수
- 변수명numOfRows
- 타입string
- 필수여부false
페이지수
- 변수명pageNo
- 타입string
- 필수여부false
검색어
- 변수명keyword
- 타입string
- 필수여부false

출력 값

출력 값 상세표
No	변수명	출력설명
1	rn	번호
2	abstractDesc	자원의 대한 요약
3	affiliation	소속
4	alternativeTitle	대체
5	charge	요금 정보
6	collectionDb	소속(통제)DB
7	contributor	기여자
8	copyrightOthers	저작권
9	coverage	내용의범위
10	createdDate	제작일
11	creator	주된 책임을 진 개체
12	description	내용
13	digitalizedDate	디지털화 데이터
14	extent	자원의 크기나 재생시간
15	format	자원의 물리적, 디지털 구현형
16	grade	등급 정보
17	identifier	자원의식별
18	insertDate	자원이용일(수집일)
19	issuedDate	발행일
20	language	언어
21	medium	자원의물리적(물질적)상태
22	period	기간
23	person	사람
24	publisher	발행기관
25	reference	참조한자원
26	referenceIdentifier	참조식별정보(썸네일이미지)
27	regDate	등록일
28	relation	관련자원
29	rights	자원에 대한 권리
30	source	유래자원에 대한 참조
31	spatial	공간
32	subjectCategory	기관별주제분류체계
33	subjectKeyword	핵심주제어(키워드)
34	subDescription	보조 서술
35	tableOfContents	목차정보
36	temporal	시간적범위
37	time	시간
38	title	자원의 명칭
39	type	해당자원의 성격, 장르
40	uci	지식정보자원식별체계
41	url	지식정보자원위치정보
42	venue	장소

메시지 설명

0000
정상 처리
F2013
서비스 주소 호출 실패
9999
서비스 점검중(내부 서비스 호출 장애)

활용 명세

※ parameter(조회조건)에 numOfRow, pageNo 외의 다른 조건이 있을 경우, 빈 값이더라도 다음 샘플과 같이 공백인 조건을 포함하여 [(샘플)&keyword=] 를 추가하여 호출하시기 바랍니다.

외국인을 위한 우리말 배우기

1.0

OAS3

/data/openapi/getSwagger.do?openApiId=aa58efd3-2a51-4801-98ef-d32a519801f4&csrfToken=5f52f53a-f927-4081-bea2-52eaec2ef5d3&id=375

Servers

default

샘플 데이터

>샘플 데이터 상세
번호	자원의 대한 요약	대체	내용	자원이용일(수집일)	등록일	기관별주제분류체계	목차정보	자원의 명칭	지식정보자원위치정보
1	チュクミ・ジョンゴル	ocellated octopus hot pot	小章魚火鍋	2017-11-28 10:09:04.0	2017-07-27 00:00:00.0	B01006	イイダコの寄せ鍋	주꾸미전골	http://api.visitkorea.or.kr/openapi/service/rest/TransService/transWord?1511831345833
2	チュオ・ジョンゴル	loach hot pot	泥鰍火鍋	2017-11-28 10:09:04.0	2017-07-27 00:00:00.0	B01006	どじょうの寄せ鍋	추어전골	http://api.visitkorea.or.kr/openapi/service/rest/TransService/transWord?1511831345923
3	ファンテ・ジョンゴル	dried pollack hot pot	乾明太魚火鍋	2017-11-28 10:09:04.0	2017-07-27 00:00:00.0	B01006	スケトウダラの寄せ鍋	황태전골	http://api.visitkorea.or.kr/openapi/service/rest/TransService/transWord?1511831345951
4	アグィ・ジョンゴル	monkfish hot pot	鮟鱇魚火鍋	2017-11-28 10:09:04.0	2017-07-27 00:00:00.0	B01006	アンコウの寄せ鍋	아귀전골	http://api.visitkorea.or.kr/openapi/service/rest/TransService/transWord?1511831345996
5	マンドゥ・ジョンゴル	dumpling hot pot	餃子火鍋	2017-11-28 10:09:04.0	2017-07-27 00:00:00.0	B01006	餃子の寄せ鍋	만두전골	http://api.visitkorea.or.kr/openapi/service/rest/TransService/transWord?1511831346145

샘플코드

/* 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/convergence2017/conver5"); /*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")); /*검색어*/

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

conn.setRequestMethod("GET");
conn.setRequestProperty("Content-type", "application/json");
//json type으로 응답받고 싶을 때는 아래 주석을 제거하시고 사용바랍니다.
//conn.setRequestProperty("Accept","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/convergence2017/conver5'; /*URL*/
var queryParams = '?' + encodeURIComponent('serviceKey') + '=' + '서비스키'; /*서비스키*/
queryParams += '&' + encodeURIComponent('numOfRows') + '=' + encodeURIComponent('세션당 요청레코드수'); /*세션당 요청레코드수*/
queryParams += '&' + encodeURIComponent('pageNo') + '=' + encodeURIComponent('페이지수'); /*페이지수*/
queryParams += '&' + encodeURIComponent('keyword') + '=' + 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("rn" + $(this).find("rn").text());
console.log("abstractDesc" + $(this).find("abstractDesc").text());
console.log("affiliation" + $(this).find("affiliation").text());
console.log("alternativeTitle" + $(this).find("alternativeTitle").text());
console.log("charge" + $(this).find("charge").text());
console.log("collectionDb" + $(this).find("collectionDb").text());
console.log("contributor" + $(this).find("contributor").text());
console.log("copyrightOthers" + $(this).find("copyrightOthers").text());
console.log("coverage" + $(this).find("coverage").text());
console.log("createdDate" + $(this).find("createdDate").text());
console.log("creator" + $(this).find("creator").text());
console.log("description" + $(this).find("description").text());
console.log("digitalizedDate" + $(this).find("digitalizedDate").text());
console.log("extent" + $(this).find("extent").text());
console.log("format" + $(this).find("format").text());
console.log("grade" + $(this).find("grade").text());
console.log("identifier" + $(this).find("identifier").text());
console.log("insertDate" + $(this).find("insertDate").text());
console.log("issuedDate" + $(this).find("issuedDate").text());
console.log("language" + $(this).find("language").text());
console.log("medium" + $(this).find("medium").text());
console.log("period" + $(this).find("period").text());
console.log("person" + $(this).find("person").text());
console.log("publisher" + $(this).find("publisher").text());
console.log("reference" + $(this).find("reference").text());
console.log("referenceIdentifier" + $(this).find("referenceIdentifier").text());
console.log("regDate" + $(this).find("regDate").text());
console.log("relation" + $(this).find("relation").text());
console.log("rights" + $(this).find("rights").text());
console.log("source" + $(this).find("source").text());
console.log("spatial" + $(this).find("spatial").text());
console.log("subjectCategory" + $(this).find("subjectCategory").text());
console.log("subjectKeyword" + $(this).find("subjectKeyword").text());
console.log("subDescription" + $(this).find("subDescription").text());
console.log("tableOfContents" + $(this).find("tableOfContents").text());
console.log("temporal" + $(this).find("temporal").text());
console.log("time" + $(this).find("time").text());
console.log("title" + $(this).find("title").text());
console.log("type" + $(this).find("type").text());
console.log("uci" + $(this).find("uci").text());
console.log("url" + $(this).find("url").text());
console.log("venue" + $(this).find("venue").text());

});

};

}
xhr.send('');

맞춤형 API 상세

국립국어원 외_외국인을 위한 우리말 배우기

기본정보

오픈 API

요청인자

출력 값

메시지 설명

활용 명세

외국인을 위한 우리말 배우기 1.0 OAS3

default

Schemas

샘플 데이터

샘플코드

연관 오픈API

한국문화정보원_방방곳곳 트래킹 안내 서비스

한국정책방송원_역사기록정보

문화체육관광부_일자리정보-채용정보

한국문화정보원 외_전시정보(통합)

한국문화정보원_전국 시티투어 코스와 함께하는 맛집 정보

한국문화정보원_전국 관광지 주변_전기차 충전소

한국문화정보원_전국 박물관 미술관_공연행사

한국문화정보원_초중고등학교 주변 도서관 정보

한국문화정보원_전통시장 주변 공영주차장 정보

한국문화정보원 외_공연정보(통합)

한국문화정보원_국립공원 주변 문화시설 POI 정보

한국문화정보원 외_공연과 함께하는 CO2 줄이기

한국문화정보원 외_역사가 있는 여행 이야기

서울올림픽기념국민체육진흥공단 외_어디서 운동할까

국립국어원 외_한국이 좋아요

제주특별자치도청 외_씽씽 자전거와 함께 하는 여행

한국문화정보원 외_가족과 함께하는 농어촌 체험일기

서울특별시청_반려 동물을 위한 지역 생활정보

한국문화예술위원회 외_길 위의 작은 가게

한국문화관광연구원 외_맑은 하늘과 함께 하는 여행

문화체육관광부 외_사서의 책장

해외문화홍보원 외_이벤트 알림이

국립중앙박물관 외_문화교육의 시작

인천문화재단 외_여행은 체험하는 것

서울문화재단 외_문화부문 채용정보

한국문화정보원_어린이를 위한 공연정보

한국문화정보원_관광지 안전정보

한국문화정보원_문화기반시설 통계정보

한국문화정보원_소소하지만 확실한 여행

한국문화정보원_공공미술 작품을 찾아서

문화체육관광부_일자리정보-일자리뉴스

문화체육관광부_일자리정보-시험정보

국립중앙박물관 외_지도로 보는 문화재 탐방

한국문화정보원 외_도서정보조회 서비스

한국문화정보원_장애인을 위한 시설정보

국립국어원 외_외국인을 위한 우리말 배우기

한국학중앙연구원 외_한국의 향토문화

영상물등급위원회 외_무비갤러리

한국문화정보원_방방곳곳 트래킹 안내 서비스

한국정책방송원_역사기록정보

문화체육관광부_일자리정보-채용정보

한국문화정보원 외_전시정보(통합)

한국문화정보원_전국 시티투어 코스와 함께하는 맛집 정보

한국문화정보원_전국 관광지 주변_전기차 충전소

외국인을 위한 우리말 배우기
1.0
OAS3