이 누리집은 대한민국 공식 전자정부 누리집입니다.
1. 韓国語基礎辞典オープンAPIサービスの紹介
オープンAPIとは？
一つのウェブサイトで自分の持っている機能を利用できるように公開したプログラミングインターフェースをオープンAPIといいます。2. 韓国語基礎辞典オープンAPIサービスの認証キー発行
3. 韓国語基礎辞典オープンAPIサービス利用のご案内
オープンAPIリクエストURL
検索リクエスト変数(Request Parameters)
| リクエスト変数 | タイプ | 許容値 | 必須/選択 | 説明 |
|---|---|---|---|---|
| key | string | 16進数32桁 | 必須 | 認証キー |
| q | string | - | 必須 | 検索ワード(UTF-8エンコーディング) |
| start | integer | 1~1000 | 選択 | 検索の開始番号（基本値 1） |
| num | integer | 10~100 | 選択 | 検索結果出力件数（基本値 10） |
| sort | string | dict popular |
選択 | - 整列方式（基本値 dict） dict: 사전 순 popular: 많이 찾은 순 |
| part | string | word ip dfn exam |
選択 | - 検索対象（基本値 word） word: 어휘 ip: 관용구, 속담 dfn: 뜻풀이 exam: 용례 |
| translated | string | n y |
選択 | - 多言語翻訳の有無（基本値 -n） yの場合、翻訳言語変数が適用される。 |
| trans_lang | string | 0-11 | 選択 | * リクエスト変数「translated（多言語翻訳）」が「y」の場合に設定できる。 - 翻訳言語（基本値 0 - 全翻訳言語） - 以下の値を複数選択できるようにコンマ（,）で区切って並べる。 전체(0), 영어(1), 일본어(2), 프랑스어(3), 스페인어(4), 아랍어(5), 몽골어(6), 베트남어(7), 타이어(8), 인도네시아어(9), 러시아어(10), 중국어(11) |
| advanced | string | n y |
選択 | - 詳細検索有無 (基本値 -n） yの場合、翻訳言語変数が適用される。 |
※ 下段のリクエスト変数を使用するには、詳細検索有無（基本値 n）を表す「advanced」リクエスト変数を「y」にしなければなりません。 |
||||
| target | integer | 1~10 | 選択 |
- 検索対象（基本値1 – 見出し語)
어휘(표제어)(1), 뜻풀이(2), 용례(3), 원어(4), 발음(5), 활용(6), 활용의 준말(7), 관용구(8), 속담(9), 참고 정보(10) |
| lang | integer | 0~49 | 選択 |
※ リクエスト変数「target（探す対象）」が「原語（4）」である場合は、リクエスト変数「lang（言語）」を設定することができる。
- 言語（基本値 0 - 全体） 전체(0), 고유어(1), 한자(2), 안 밝힘(3), 영어(4), 그리스어(5), 네덜란드어(6), 노르웨어어(7), 독일어(8), 라틴어(9), 러시아어(10), 루마니아어(11), 마오리어(12), 말레이어(13), 몽골어(14), 바스크어(15), 버마어(16), 베트남어(17), 불가리어어(18), 산스크리트어(19), 세르보ᆞ크로아트어(20), 스와힐리어(21), 스웨덴어(22), 아랍어(23), 아일랜드어(24), 에스파냐어(25), 우즈베크어(26), 우크라이나어(27), 이탈리아어(28), 인도네시아어(29), 일본어(30), 중국어(31), 체코어(32), 캄보디아어(33), 케추아어(34), 타갈로그어(35), 타이어(36), 터키어(37), 티베트어(38), 페르시아어(39), 포르투갈어(40), 폴란드어(41), 프랑스어(42), 프로방스어(43), 핀란드어(44), 헝가리어(45), 히브리어(46), 힌디어(47), 기타어(48), 덴마크어(49) |
| method | string |
exact
include start end |
選択 |
- 検索方式（基本値 exact）
exact: 일치 검색 include: 포함 검색 start: 시작 end: 끝 |
| type1 | array of string |
all
word phrase expression |
選択 |
- 区分 1 (基本値 all)
- 以下の値を複数選択できるようにコンマ（,）で区切って並べる。 word: 단어 phrase: 구 expression: 문법 표현 |
| type2 | array of string |
all
native chinese loanword hybrid |
選択 |
- 区分 2 （基本値 all）
- 以下の値を複数選択できるようにコンマ（,）で区切って並べる。 native: 고유어 chinese: 한자어 loanword: 외래어 hybrid: 혼종어 |
| level | array of string |
all
level1 level2 level3 |
選択 |
- レベル別語彙（基本値 all）
- 以下の値を複数選択できるようにコンマ（,）で区切って並べる。 level1: 초급 level2: 중급 level3: 고급 |
| pos | array of integer | 0 ~ 15 | 選択 |
- 品詞（基本値0 - 全体の品詞）
- 以下の値を複数選択できるようにコンマ（,）で区切って並べる。 전체(0), 명사(1), 대명사(2), 수사(3), 조사(4), 동사(5), 형용사(6), 관형사(7), 부사(8), 감탄사(9), 접사(10), 의존 명사(11), 보조 동사(12), 보조 형용사(13), 어미(14), 품사 없음(15) |
| multimedia | array of integer | 0 ~ 6 | 選択 |
- マルチメディア情報（基本値 0 – 全体）
- 以下の値を複数選択できるようにコンマ（,）で区切って並べる。 전체(0), 사진(1), 삽화(2), 동영상(3), 애니메이션(4), 소리(5), 없음(6) |
| letter_s | integer | 1 ~ | 選択 | - 音節数のスタート（基本値 1） |
| letter_e | integer | 0 ~ | 選択 |
- 音節数の終わり（基本値 0）
– 基本値 0はすべての音節数を意味する。 |
| sense_cat | array of integer | 0 ~ 153 | 選択 |
- 意味のカテゴリ（基本値 0 – 全体）
전체(0), 인간 > 전체(1), 인간 > 사람의 종류(2), 인간 > 신체 부위(3), 인간 > 체력 상태(4), 인간 > 생리 현상(5), 인간 > 감각(6), 인간 > 감정(7), 인간 > 성격(8), 인간 > 태도(9), 인간 > 용모(10), 인간 > 능력(11), 인간 > 신체 변화(12), 인간 > 신체 행위(13), 인간 > 신체에 가하는 행위(14), 인간 > 인지 행위(15), 인간 > 소리(16), 인간 > 신체 내부 구성(17), 삶 > 전체(18), 삶 > 삶의 상태(19), 삶 > 삶의 행위(20), 삶 > 일상 행위(21), 삶 > 친족 관계(22), 삶 > 가족 행사(23), 삶 > 여가 도구(24), 삶 > 여가 시설(25), 삶 > 여가 활동(26), 삶 > 병과 증상(27), 삶 > 치료 행위(28), 삶 > 치료 시설(29), 삶 > 약품류(30), 식생활 > 전체(31), 식생활 > 음식(32), 식생활 > 채소(33), 식생활 > 곡류(34), 식생활 > 과일(35), 식생활 > 음료(36), 식생활 > 식재료(37), 식생활 > 조리 도구(38), 식생활 > 식생활 관련 장소(39), 식생활 > 맛(40), 식생활 > 식사 및 조리 행위(41), 의생활 > 전체(42), 의생활 > 옷 종류(43), 의생활 > 옷감(44), 의생활 > 옷의 부분(45), 의생활 > 모자, 신발, 장신구(46), 의생활 > 의생활 관련 장소(47), 의생활 > 의복 착용 상태(48), 의생활 > 의복 착용 행위(49), 의생활 > 미용 행위(50), 주생활 > 전체(51), 주생활 > 건물 종류(52), 주생활 > 주거 형태(53), 주생활 > 주거 지역(54), 주생활 > 생활 용품(55), 주생활 > 주택 구성(56), 주생활 > 주거 상태(57), 주생활 > 주거 행위(58), 주생활 > 가사 행위(59), 사회 생활 > 전체(60), 사회 생활 > 인간관계(61), 사회 생활 > 소통 수단(62), 사회 생활 > 교통 수단(63), 사회 생활 > 교통 이용 장소(64), 사회 생활 > 매체(65), 사회 생활 > 직장(66), 사회 생활 > 직위(67), 사회 생활 > 직업(68), 사회 생활 > 사회 행사(69), 사회 생활 > 사회 생활 상태(70), 사회 생활 > 사회 활동(71), 사회 생활 > 교통 이용 행위(72), 사회 생활 > 직장 생활(73), 사회 생활 > 언어 행위(74), 사회 생활 > 통신 행위(75), 사회 생활 > 말(76), 경제 생활 > 전체(77), 경제 생활 > 경제 행위 주체(78), 경제 생활 > 경제 행위 장소(79), 경제 생활 > 경제 수단(80), 경제 생활 > 경제 산물(81), 경제 생활 > 경제 상태(82), 경제 생활 > 경제 행위(83), 교육 > 전체(84), 교육 > 교수 학습 주체(85), 교육 > 전공과 교과목(86), 교육 > 교육 기관(87), 교육 > 학교 시설(88), 교육 > 학습 관련 사물(89), 교육 > 학문 용어(90), 교육 > 교수 학습 행위(91), 교육 > 학문 행위(92), 종교 > 전체(93), 종교 > 종교 유형(94), 종교 > 종교 활동 장소(95), 종교 > 종교인(96), 종교 > 종교어(97), 종교 > 신앙 대상(98), 종교 > 종교 활동 도구(99), 종교 > 종교 행위(100), 문화 > 전체(101), 문화 > 문화 활동 주체(102), 문화 > 음악(103), 문화 > 미술(104), 문화 > 문학(105), 문화 > 예술(106), 문화 > 대중 문화(107), 문화 > 전통 문화(108), 문화 > 문화 생활 장소(109), 문화 > 문화 활동(110), 정치와 행정 > 전체(111), 정치와 행정 > 공공 기관(112), 정치와 행정 > 사법 및 치안 주체(113), 정치와 행정 > 무기(114), 정치와 행정 > 정치 및 치안 상태(115), 정치와 행정 > 정치 및 행정 행위(116), 정치와 행정 > 사법 및 치안 행위(117), 정치와 행정 > 정치 및 행정 주체(118), 자연 > 전체(119), 자연 > 지형(120), 자연 > 지표면 사물(121), 자연 > 천체(122), 자연 > 자원(123), 자연 > 재해(124), 자연 > 기상 및 기후(125), 동식물 > 전체(126), 동식물 > 동물류(127), 동식물 > 곤충류(128), 동식물 > 식물류(129), 동식물 > 동물의 부분(130), 동식물 > 식물의 부분(131), 동식물 > 동식물 행위(132), 동식물 > 동물 소리(133), 개념 > 전체(134), 개념 > 모양(135), 개념 > 성질(136), 개념 > 속도(137), 개념 > 밝기(138), 개념 > 온도(139), 개념 > 색깔(140), 개념 > 수(141), 개념 > 세는 말(142), 개념 > 양(143), 개념 > 정도(144), 개념 > 순서(145), 개념 > 빈도(146), 개념 > 시간(147), 개념 > 위치 및 방향(148), 개념 > 지역(149), 개념 > 지시(150), 개념 > 접속(151), 개념 > 의문(152), 개념 > 인칭(153) |
| subject_cat | array of integer | 0 ~ 106 | 選択 |
- テーマ及び状況のカテゴリ（基本値 0– 全体）
- 以下の値を複数選択できるようにコンマ（,）で区切って並べる。 전체(0), 인사하기(1), 소개하기(자기소개)(2), 소개하기(가족소개)(3), 개인 정보 교환하기(4), 위치 표현하기(5), 길찾기(6), 교통 이용하기(7), 물건 사기(8), 음식 주문하기(9), 요리 설명하기(10), 시간 표현하기(11), 날짜 표현하기(12), 요일 표현하기(13), 날씨와 계절(14), 하루 생활(15), 학교생활(16), 한국 생활(17), 약속하기(18), 전화하기(19), 감사하기(20), 사과하기(21), 여행(22), 주말 및 휴가(23), 취미(24), 가족 행사(25), 건강(26), 병원 이용하기(27), 약국 이용하기(28), 공공 기관 이용하기(도서관)(29), 공공 기관 이용하기(우체국)(30), 공공 기관 이용하기(출입국 관리 사무소)(31), 초대와 방문(32), 집 구하기(33), 집안일(34), 감정, 기분 표현하기(35), 성격 표현하기(36), 복장 표현하기(37), 외모 표현하기(38), 영화 보기(39), 개인 정보 교환하기(40), 교통 이용하기(41), 지리 정보(42), 물건 사기(43), 음식 설명하기(44), 요리 설명하기(45), 날씨와 계절(46), 학교생활(47), 한국 생활(48), 직업과 진로(49), 직장 생활(50), 여행(51), 주말 및 휴가(52), 취미(53), 가족 행사(54), 가족 행사(명절)(55), 건강(56), 공공기관 이용하기(57), 초대와 방문(58), 집 구하기(59), 집안일(60), 감정, 기분 표현하기(61), 성격 표현하기(62), 복장 표현하기(63), 외모 표현하기(64), 공연과 감상(65), 대중 매체(66), 컴퓨터와 인터넷(67), 사건, 사고, 재해 기술하기(68), 환경 문제(69), 문화 비교하기(70) , 인간관계(71), 한국의 문학(72), 문제 해결하기(분실 및 고장)(73), 실수담 말하기(74), 연애와 결혼(75), 언어(76), 지리 정보(77), 경제∙경영(78), 식문화(79), 기후(80), 교육(81), 직업과 진로(82), 직장 생활(83), 여가 생활(84), 보건과 의료(85), 주거 생활(86), 심리(87), 외양(88), 대중문화(89), 컴퓨터와 인터넷(90), 사회 문제(91), 환경 문제(92), 사회 제도(93), 문화 차이(94), 인간관계(95), 예술(96), 건축(97), 과학과 기술(98), 법(99), 스포츠(100), 언론(101), 언어(102), 역사(103), 정치(104), 종교(105), 철학∙윤리(106) |
検索出力結果フィールド（Response field）: XML形式（共通）
| フィールド | タイプ | 必須/選択 | 説明 |
|---|---|---|---|
| channel | - | 必須 | 結果を含むコンテナ |
| title | string | 必須 | 韓国語基礎辞典検索オープンAPI題名（固定値） 韓国語基礎辞典オープンAPI - 辞書検索 |
| link | string | 必須 | 韓国語基礎辞典URL（固定値） https://krdict.korean.go.kr |
| description | string | 必須 | オープンAPIサービスの説明（固定値） 韓国語基礎辞典オープンAPI – 辞書検索結果 |
| lastBuildDate | datetime | 必須 | 検索結果を生成した時間 |
| total | integer | 必須 | 検索された全体の語彙数 |
| start | integer | 必須 | 検索結果の開始番号 |
| num | integer | 必須 | 検索結果として提供する語彙の数 |
検索出力結果のフィールド（Response field）: XML形式（語彙、慣用句、ことわざ、意味記述の出力結果）
| フィールド | タイプ | 必須/選択 | 説明 |
|---|---|---|---|
| item | - | 必須 | 個々の検索結果を含むコンテナ。「num」だけ繰り返す。 |
| target_code | integer | 必須 | 識別コード |
| word | string | 必須 | 見出し語 |
| sup_no | integer | 必須 | 同形語番号 |
| origin | string | 選択 | 原語 |
| pronunciation | string | 選択 | 発音 |
| word_grade | string | 選択 | 語彙レベル |
| pos | string | 必須 | 品詞 |
| link | string | 必須 | 辞書の内容を見るURL |
| sense | string | 必須 | 個々の意味を含むコンテナ |
| sense_order | integer | 必須 | 個別意味順 |
| definition | string | 必須 | 意味 |
| translation | string | 選択 | 個々の意味を含むコンテナ（senseの下位element） |
| trans_word | string | 選択 | 見出し語の翻訳 |
| trans_dfn | string | 選択 | 意味の翻訳 |
検索出力結果のフィールド（Response field）: XML形式（用例検索の出力結果）
| フィールド | タイプ | 必須/選択 | 説明 |
|---|---|---|---|
| item | - | 必須 | 個々の検索結果を含むコンテナ。「num」だけ繰り返す。 |
| target_code | integer | 必須 | 識別コード |
| word | string | 必須 | 見出し語 |
| sup_no | integer | 必須 | 同形語番号 |
| example | string | 必須 | 用例 |
| link | string | 必須 | 辞書の内容を見るURL |
検索エラーメッセージ（error message）
| エラーコード | エラーメッセージ | 説明 |
|---|---|---|
| 000 | System error | システムエラー |
| 010 | Daily API Limit Exceeded | 1日間許可されたAPI呼び出し限度（50000件）を超過 |
| 020 | Unregistered key | 未登録の認証キー |
| 021 | Your key is temporary unavailable | 一時的に使用中止になった認証キー |
| 100 | Incorrect query request | 不適切なクエリリクエスト。queryフィールド自体がない場合に発生するエラーメッセージ |
| 101 | Invalid target value | 不適切な検索フィールド |
| 102 | Invalid method value | 不適切な検索方法 |
| 103 | Invalid num value | 不適切な検索数 |
| 104 | Invalid start value | 不適切なstart値 |
| 105 | Invalid sort value | 不適切な整列順 |
| 106 | Invalid part value | 不適切な検索対象値 |
| 107 | Invalid translated value | 不適切な多言語翻訳有無の対象値 |
| 108 | Invalid trans_lang value | 不適切な翻訳言語の対象値 |
| 109 | Invalid advanced value | 不適切な詳細検索の有無 |
| 110 | Invalid lang value | 不適切な言語の値 |
| 200 | Invalid type1 value | 不適切なtype1の値 |
| 201 | Invalid type2 value | 不適切なtype2の値 |
| 203~209 | - | 予約 |
| 210 | Invalid pos value | 不適切な品詞 |
| 211 | Invalid level value | 不適切な語彙レベル |
| 212 | Invalid multimedia value | 不適切なマルチメディア |
| 213 | Invalid sense_cat value | 不適切な意味のカテゴリ |
| 214 | Invalid subject_cat value | 不適切なテーマおよび状況のカテゴリ |
| 215 | Invalid letter_s value | 不適切な音節数のスタート |
| 216 | Invalid letter_e value | 不適切な音節数の終わり |
語彙検索の時の出力XMLの例
<?xml version="1.0" encoding="UTF-8" ?>
<channel>
<title>한국어 기초사전 개발 지원(Open API) - 사전 검색</title>
<link>https://krdict.korean.go.kr</link>
<description>한국어 기초사전 개발 지원(Open API) - 사전 검색 결과</description>
<lastBuildDate>2017-11-14 14:12:51</lastBuildDate>
<total>53</total>
<start>1</start>
<num>10</num>
<item>
<target_code>32750</target_code>
<word>나무</word>
<sup_no>0<sup_no>
<pronunciation>나무<pronunciation>
<word_grade>초급<word_grade>
<pos>명사</pos>
<link>https://krdict.korean.go.kr/dicSearch/SearchView?paraWordNo=32750</link>
<sense>
<sense_order>1</sense_order>
<definition>줄기나 가지가 목질로 된 여러해살이 식물.</definition>
<translation>
<trans_lang>영어</trans_lang>
<trans_word>tree</trans_word>
<trans_dfn>A plant with a hard stem, branches and leaves.</trans_dfn>
</translation>
<translation>
<trans_lang>일본어</trans_lang>
<trans_word>き【木・樹】。じゅもく【樹木】</trans_word>
<trans_dfn>しっかりした幹に枝と葉がついた、数年間にわたって育つ植物。</trans_dfn>
</translation>
</sense>
<sense>
<sense_order>2</sense_order>
<definition>집이나 가구 등을 만드는 데 사용하는 재목.</definition>
<translation>
<trans_lang>영어</trans_lang>
<trans_word>wood</trans_word>
<trans_dfn>The material used to build a house or to make furniture.</trans_dfn>
</translation>
<translation>
<trans_lang>일본어</trans_lang>
<trans_word>き【木・樹】。ざいもく【材木】</trans_word>
<trans_dfn>住宅や家具などを作るのに用いる材木。</trans_dfn>
</translation>
</sense>
<sense>
<sense_order>3</sense_order>
<definition>불을 때기 위해 베어 놓은 나무의 줄기나 가지.</definition>
<translation>
<trans_lang>영어</trans_lang>
<trans_word>timber; log</trans_word>
<trans_dfn>The trunk or branches of a tree cut to be used as firewood.</trans_dfn>
</translation>
<translation>
<trans_lang>일본어</trans_lang>
<trans_word>まき・たきぎ【薪】</trans_word>
<trans_dfn>火をたくために切った木の幹や枝。</trans_dfn>
</translation>
</sense>
</item>
<item>
</channel>
用例検索の時の出力XMLの例
<?xml version="1.0" encoding="UTF-8" ?>
<channel>
<title>한국어 기초사전 개발 지원(Open API) - 사전 검색</title>
<link>https://krdict.korean.go.kr</link>
<description>한국어 기초사전 개발 지원(Open API) - 사전 검색 결과</description>
<lastBuildDate>2017-11-14 14:24:31</lastBuildDate>
<total>2277</total>
<start>1</start>
<num>10</num>
<item>
<target_code>27965</word>
<word>가공성</word>
<sup_no>0</sup_no>
<example>나무가 지나치게 단단하면 변형이 어려워 가공성이 떨어진다. </example>
<link>https://krdict.korean.go.kr/dicSearch/SearchView?ParaWordNo=27965</link>
</item>
<item>
<target_code>28027</word>
<word>가공하다</word>
<sup_no>1</sup_no>
<example>집 앞 공장에서는 나무를 가공하여 여러 가지 가구를 만든다. </example>
<link>https://krdict.korean.go.kr/dicSearch/SearchView?ParaWordNo=28027</link>
</item>
</channel>
検索出力エラーメッセージXMLの例
| エラーメッセージXMLの仕組み | エラーメッセージXMLの例 |
|---|---|
|
<?xml version="1.0" encoding="UTF-8" ?>
<error_code>에러코드</error_code> </error> |
<?xml version="1.0" encoding="UTF-8" ?>
<error_code>020</error_code> </error> |
