메인콘텐츠 바로가기
이 누리집은 대한민국 공식 전자정부 누리집입니다.

공식 누리집 주소 확인하기

go.kr 주소를 사용하는 누리집은 대한민국 정부 기관이 관리하는 누리집입니다.
이밖에 or.kr 또는 .kr 등 다른 도메인 주소를 사용하고 있다면 아래 URL에서 도메인 주소를 확인해 보세요.

운영 중인 공식 누리집 보기

개발 지원(Open API)

검색

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

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

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

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

외래어, 로마자 용례 오픈 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
※ 항목구분 : 필수(1), 옵션(0), 1건 이상 복수 건(1..n), 0건 또는 복수 건(0..n)