정책지원 상세

국립국어원_통합 수어정보

기본정보

URL

https://api.kcisa.kr/API_CNV_054/request
설명

국립국어원 운영 통합 수어정보(전문용어수어, 문화정보수어, 일생생활수어 등)를 웹 개발자 및 사용자가 활용 할 수 있도록 한국수어 어휘에 대한 한국어 설명 정보와 부가 정보(수형 영상물 및 이미지 경로 URL, UCI 식별자 등)를 통합 제공하는 API 서비스 입니다.

# 2025.04.25. 수형설명, 수형이미지 컬럼이 추가되었습니다.
signDescription[수형 설명] 및 signImages [수형 이미지(`,`로 구분하여 n건 추출)] 항목이 추가 되었습니다.
다만, 일상생활 수어, 전문용어 수어에 해당하며 collectionDb (분류) 항목으로 구분 가능 합니다.
(문화정보 수어는 국립국어원에서 제공 불가하여 컬럼만 추가되고 값은 공백 상태입니다.)

# 2025.05.22. 분류항목 컬럼이 추가되었습니다.
○ 문화정보수어(국립 경주 박물관/국립 공주 박물관/국립 과천 과학관/국립 광주 박물관/국립 나주 박물관/국립 민속 박물관/국립 부여 박물관/국립 중앙 박물관/국립 진주 박물관/국립 춘천 박물관/국립 한글 박물관/대한민국 역사 박물관)
○ 전문용어수어(경제/교통/국어 교과 용어/기독교/법률/불교/의학/정보통신/정치/천주교)
○ 일반생활수어(개념/경제생활/교육/기타/나라명 및 지명/동식물/문화/사회생활/삶/식생활/의생활/인간/자연/정치와 행정/종교/주생활)

★★★★★ 주의 사항 ★★★★
URL 호출 시 parameter 에 numOfRow, pageNo 외의 keyword는 빈 값이더라도 다음 샘플과 같이 공백으로 [(샘플)&keyword=] 호출하시기 바랍니다.
http://api.kcisa.kr/API_CNV_054/request?serviceKey={서비스키}&numOfRows=10&pageNo=1&keyword=&collectionDb=
제공기관

국립국어원
API 키워드

수어,통합수어,수어정보,한국수어
서비스 분류
- 정책지원
- 창작물
- 기타창작물
API유형

REST
API 등록일

2022-01-24

호출건수

21,609
데이터 수정일

2022-01-28

갱신주기

상시

오픈 API

요청인자

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

출력 값

출력 값 상세표
No	변수명	출력설명
1	title	제목
2	alternativeTitle	부제
3	description	설명
4	subDescription	부가설명
5	localId	원천기관자료식별자
6	viewCount	조회수
7	url	URL
8	imageObject	이미지(썸네일)
9	period	기간
10	signDescription	수형 설명
11	signImages	수형 이미지(`,` 쉼표로 구분하여 n건 추출)
12	collectionDb	수어유형
13	categoryType	수어유형별_분류항목

메시지 설명

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

활용 명세

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

샘플 데이터

샘플코드

/* 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("https://api.kcisa.kr/API_CNV_054/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")); /*페이지수*/
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 = 'https://api.kcisa.kr/API_CNV_054/request'; /*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("title" + $(this).find("title").text());
console.log("alternativeTitle" + $(this).find("alternativeTitle").text());
console.log("description" + $(this).find("description").text());
console.log("subDescription" + $(this).find("subDescription").text());
console.log("localId" + $(this).find("localId").text());
console.log("viewCount" + $(this).find("viewCount").text());
console.log("url" + $(this).find("url").text());
console.log("imageObject" + $(this).find("imageObject").text());
console.log("period" + $(this).find("period").text());
console.log("signDescription" + $(this).find("signDescription").text());
console.log("signImages" + $(this).find("signImages").text());
console.log("collectionDb" + $(this).find("collectionDb").text());
console.log("categoryType" + $(this).find("categoryType").text());

});

};

}
xhr.send('');

정책지원 상세

국립국어원_통합 수어정보

기본정보

오픈 API

요청인자

출력 값

메시지 설명

활용 명세

샘플 데이터

샘플코드

연관 오픈API

국립국어원_외래어표기법

국립국어원_일상생활수어

국립국어원_전문용어수어

국립국어원_문화정보수어

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

한국저작권위원회_용어사전

국립국어원_우리말샘

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

국립국어원_통합 수어정보

국립국어원_한국어기초사전_NEW

오픈 API 활용 신청

오픈 API 활용 신청

오픈 API 활용 신청

오픈 API 활용 신청

오픈API 오류신고