한국어 어문 규범

개발 지원(Open API)

검색

외래어, 로마자 용례 오픈 API 서비스 소개

외래어, 로마자 용례 오픈 API는 검색 플랫폼을 외부에 공개하여 다양하고 재미있는 서비스 및 애플리케이션을 개발할 수 있도록 외부 개발자와 사용자들이 공유하는 프로그램입니다.
용례 찾기에 구축된 양질의 정보를 개인 또는 기관에서 오픈 API를 이용해 자유롭게 이용할 수 있도록 제공합니다.
※ 오픈 API란?
하나의 웹사이트에서 자신이 가진 기능을 이용할 수 있도록 공개한 프로그래밍 인터페이스를 오픈 API라고 합니다.

외래어, 로마자 용례 오픈 API 서비스 인증 키 발급

오픈 API 서비스를 이용하기 위해서는 먼저 인증 키를 발급받아야 합니다. 인증 키가 올바르지 않은 경우에는 서비스 이용이 제한됩니다.
인증 키가 유효하지 않거나 인증 키를 분실한 경우에는 인증 키를 재발급받아야 합니다.
※ 1인당 1개의 인증 키를 발급받을 수 있습니다.

신규 키 발급

신규 키 발급 정보 입력
이름
전화번호
사용 URL
신규 키

※ 정확하지 않은 정보를 기입하는 경우 서비스 이용이 정지될 수 있습니다.

기존 키 찾기

기존 키 검색 정보 입력
이름
전화번호
키

외래어, 로마자 용례 오픈 API 서비스 이용 안내

연계 표준 서비스를 이용하기 위한 XML/JSON 기반의 데이터 형식, 갱신 데이터 요청 변수, 반환되는 코드값을 제공합니다.

요청 메시지 명세

오픈 API 요청 URL : https://korean.go.kr/kornorms/exampleReqList.do

정보 검색
항목명(영문)	항목명(국문)	항목크기	항목구분	샘플 데이터	항목설명
serviceKey	인증 키	100	1	인증 키 (URL Encode)	발급받은 인증 키
pageNo	페이지 번호	4	1	1	페이지 번호
numOfRows	한 페이지 결과 수	4	1	10	한 페이지 결과 수
langType	언어 구분	4	1	0003	외래어 : 0003 로마자 : 0004
resultType	결과 형식	10	1	xml	xml, json
searchCondition	검색 분류	20	0	-	* 외래어, 로마자 표기법 공통 사항 - 한글 표기 : korean_mark - 관련 표기(이표기) : relate_mark_e - 관련 표기(오표기) : relate_mark_o * 외래어 표기법 - 원어 표기 : srclang_mark - 국명 : guk_nm - 언어명 : lang_nm - 의미 : mean - 출전 : source * 국어의 로마자 표기법 - 원어 표기 : roman_mark
searchEquals	단어 포함 여부	10	0	-	일치 : equal 포함 : like 시작 문자 : start 끝 문자 : end
searchKeyword	검색어	50	0	-	검색어(UTF-8 인코딩)
s_foreign_gubun	외래어 구분	4	0..n	-	* 외래어 표기법 인명 : 0001 지명 : 0002 일반 용어 : 0003
s_lclas_gubun	로마자 구분	3	0..n	-	* 국어의 로마자 표기법 행정 구역 : 001 자연 지명 : 002 교통 지명 : 003 역사 지명 : 004 명소 : 005 문화재 : 006 일반 용어 : 007 도로명 주소 : 008 기타 : 009 미지명 : 010
s_guk_nm	국명	50	0..n	-	* 외래어 표기법 국명(UTF-8 인코딩) ※ 국명_언어명.xlsx 참조
s_lang_nm	언어명	50	0..n	-	* 외래어 표기법 언어명(UTF-8 인코딩) ※ 국명_언어명.xlsx 참조

※ 항목구분 : 필수(1), 옵션(0), 1건 이상 복수 건(1..n), 0건 또는 복수 건(0..n)

응답 메시지 명세

정보 검색
항목명(영문)	항목명(국문)	항목크기	항목구분	샘플 데이터	항목설명
resultCode	결과 코드	2	1	00	결과 코드
resultMsg	결과 메세지	50	1	NORMAL SERVICE	결과 메시지
numOfRows	한 페이지 결과 수	4	1	10	한 페이지 결과 수
pageNo	페이지 번호	4	1	1	조회 페이지
totalCount	전체 결과 수	4	1	17	데이터 총개수
items	목록	-	0..n	-	목록
example_no	번호	10	0	1	번호
korean_mark	한글 표기	100	0	곤잘레즈, 마이크	한글 표기
roman_mark	로마자 표기	100	0	Gagok	로마자 표기
srclang_mark	원어 표기	100	0	Gonzalez, Mike	원어 표기
guk_nm	국명	100	0..n 0	미국	나라명
lang_nm	언어명	100	0..n	영어	언어명
foreign_gubun	외래어 구분	100	0..n 0	인명	일반 용어, 인명, 지명
lclas_gubun	로마자 구분	100	0..n	행정 구역	미지명,기타 도로명 주소 일반 용어 문화재 명소 역사 지명 교통 지명 자연 지명 행정 구역
relate_mark_e	관련 표기(이표기)	500	0	-	관련 표기(이표기)
relate_mark_o	관련 표기(오표기)	500	0	Kagok(X),Gakok(X),Kakok(X)	관련 표기(오표기)
mean	의미	500	0	미국 언론인(?~ ). 미국 헤리티지재단(The Heritage Foundation) 선임 연구원(2014~ ).	의미
regltn_path	관련 규정	500	0	-	관련 규정
source	출전	500	0	제154차 외래어 심의회(2021. 3. 8.)	출전
regltn_code	언어 구분	4	0	0003	외래어 : 0003 로마자 : 0004