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

개발 지원(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)