언어 분석 기술
언어 분석 기술은 자연어 문장의
의미를 이해하기 위한 기술로, 단어의
형태와 의미 및 문장의 구조와 의미를
분석하여 지식처리를 위한 기반 기술로
활용됩니다.
언어 분석을 위한 6종의 API는 HTTP 기반의 REST API 인터페이스로 JSON 포맷 기반의 입력 및 출력을 지원하며 ETRI에서 제공하는 API Key 인증을 통해 사용할 수 있는 Open API입니다.
사용자가 요청하는 분석 코드에 따라 형태소 분석, 어휘의미 분석(동음이의어 분석, 다의어 분석), 개체명 인식, 의존 구문분석, 의미역 인식 결과를a 제공합니다.
언어분석 기술은 문어체 대상 기술 및 구어체 대상 기술로 구분되며, 문어체의 경우 형태소분석, 개체명인식, 어휘의미분석(동형이의어분석, 다의어분석), 의존구문분석, 의미역인식 6종 기술을,
구어체의 경우 형태소분석, 개체명인식 2종 기술을 제공합니다.
언어 분석을 위한 6종의 API는 HTTP 기반의 REST API 인터페이스로 JSON 포맷 기반의 입력 및 출력을 지원하며 ETRI에서 제공하는 API Key 인증을 통해 사용할 수 있는 Open API입니다.
사용자가 요청하는 분석 코드에 따라 형태소 분석, 어휘의미 분석(동음이의어 분석, 다의어 분석), 개체명 인식, 의존 구문분석, 의미역 인식 결과를a 제공합니다.
언어분석 기술은 문어체 대상 기술 및 구어체 대상 기술로 구분되며, 문어체의 경우 형태소분석, 개체명인식, 어휘의미분석(동형이의어분석, 다의어분석), 의존구문분석, 의미역인식 6종 기술을,
구어체의 경우 형태소분석, 개체명인식 2종 기술을 제공합니다.
형태소 분석 API (문어/구어) |
형태소 분석 API는 자연어 문장에서 의미를 가진 최소 단위인 형태소(명사, 동사, 형용사, 부사, 조사, 어미 등)를 분석하는 기술로, 태그셋은 세종 태그셋을 기반으로 한 TTA 표준 형태소 태그셋 (TTAK.KO-11.0010/R1)에 기반합니다. |
---|---|
개체명 인식 API (문어/구어) |
개체명 인식 API는 인명, 지명, 기관명 등과 같은 개체명을 인식하는 기술로, 특정 개체를 표현하는 단어에 대한 의미 정보를 제공합니다. 개체명 태그셋은 15개 대분류 및 146개 세분류로 구성된 TTA 표준 개체명 태그셋 (TTAK.KO-10.0852)을 사용합니다. |
동음이의어 분석 API / 다의어 분석 API (문어) |
어휘의미 분석 (동음이의어 분석, 다의어 분석)은 어휘의 형태는 동일하지만 의미가 다른 어휘에 대해서 의미를 분석해 주는 기술로, 주변 문맥을 고려해서 가장 적합한 의미를 찾아 표준국어대사전을 기반으로 한 단어의 의미 분석 결과를 제공합니다. |
의존 구문분석 API (문어) |
의존 구문분석 API는 자연어 문장의 구조를 분석하는 기술로, 문장 내 각 어절에 대해서 지배소 어절을 인식하고, 주격, 목적격과 같은 세부 의존관계 유형을 인식하는 기술입니다. 의존관계 설정 가이드라인은 세종 구문분석 가이드라인을 기반으로 한 TTA 표준 의존 구문분석 가이드라인 (TTAK.KO-10.0853)과 제27회 한글 및 한국어 정보처리 학술대회 논문집의 “의존 구문분석을 위한 한국어 의존관계 가이드라인 및 엑소브레인 언어분석 말뭉치”[1]를 따르고 있습니다. |
의미역 인식 API (문어) |
의미역 인식 API는 서술어(predicate)와 논항(argument)의 관계를 기반으로 문장의 의미를 분석하는 기술로, 문장 내에서 표현된 각 서술어에 대해서 필수 논항(core argument)와 부가 논항(adverbal argument)를 인식합니다. 의미역 체계는 Proposition Bank(Propbank)[2] 체계를 따르고 있으며, 한국어 의미역 태깅 가이드라인은 제27회 한글 및 한국어 정보처리 학술대회 논문집의 “ExoBrain을 위한 의미역 가이드라인 및 언어처리 학습데이터 구축”[3]를 따르고 있습니다. |
API 호출 1일 허용량
기술명 | API명 | 1일 허용량 |
---|---|---|
언어 분석 기술(문어) |
· 형태소 분석 API · 개체명 인식 API · 동음이의어 분석 API · 다의어 분석 API · 의존 구문분석 API · 의미역 인식 API |
5,000건/일 (1회 사용 시 입력은 1만 글자 이하) |
언어 분석 기술(구어) |
· 형태소 분석 API · 개체명 인식 API |
5,000건/일 (1회 사용 시 입력은 1만 글자 이하) |
언어 분석 기술 API 사용하기
언어 분석을 위한 API는 REST API이며, 언어 분석을 수행할 텍스트 데이터를 HTTP 통신으로
e-PreTX 서버에 전달하면 됩니다. 서버가 제공하는 REST API의 URI는 다음과 같으며
POST 방식으로 호출해야 합니다.
POST 방식으로 호출해야 합니다.
문어체 언어분석 및 구어체 언어분석의 대상 URL은 아래와 같습니다.
문어체
http://epretx.etri.re.kr:8000/api/WiseNLU
구어체
http://epretx.etri.re.kr:8000/api/WiseNLU_spoken
[HTTP Request Header]
"Authorization" : "YOUR_ACCESS_KEY"
[HTTP Request Body]
{
"request_id": "reserved field",
"argument": {
"analysis_code": "ANALYSIS_CODE",
"text": "YOUR_SENTENCE"
}
}
위와 같은 HTTP 요청을 e-PreTX 서버로 전달하면 서버는 JSON 형태의
Text 데이터를 HTTP 응답 메시지로 반환합니다. 다음은 HTTP 응답 예제 입니다.
[HTTP Response Header]
Access-Control-Allow-Origin:*
Connection:close
Content-Length:0
Content-Type:application/json; charset=UTF-8
[HTTP Response Body]
{
"request_id": "reserved field",
"result": 0,
"return_type": "kr.re.etri.aiopen.restapi.client.dto.OpenApiLmInterfaceResult",
"return_object": {언어 분석 결과 JSON}
}
구현 예제(Python)
python 3.0을 기준으로 작성되었습니다.
HTTP 통신을 위해 urllib3 라이브러리를 사용하여 제공하고 있습니다. Python 3.0 이하의 버전에서
예제를 실행하기 위해서는 별도로 urllib3의 설치가 필요합니다.
설치에 대한 설명은 https://pypi.python.org/pypi/urllib3 를 참고하시기 바랍니다.
설치에 대한 설명은 https://pypi.python.org/pypi/urllib3 를 참고하시기 바랍니다.
urllib3 라이브러리에 대한 자세한 설명은 https://urllib3.readthedocs.io/en/latest/
에서 확인 하실 수 있습니다.
#-*- coding:utf-8 -*-
import urllib3
import json
// 언어 분석 기술 문어/구어 중 한가지만 선택해 사용
// 언어 분석 기술(문어)
openApiURL = "http://epretx.etri.re.kr:8000/api/WiseNLU"
// 언어 분석 기술(구어)
openApiURL = "http://epretx.etri.re.kr:8000/api/WiseNLU_spoken"
accessKey = "YOUR_ACCESS_KEY"
analysisCode = "ANALYSIS_CODE"
text = "YOUR_SENTENCE"
// 언어 분석 기술(문어)
text += "윤동주(尹東柱, 1917년 12월 30일 ~ 1945년 2월 16일)는 한국의 독립운동가, 시인, 작가이다." +
"중국 만저우 지방 지린 성 연변 용정에서 출생하여 명동학교에서 수학하였고, 숭실중학교와 연희전문학교를 졸업하였다. 숭실중학교 때 처음 시를 발표하였고, 1939년 연희전문 2학년 재학 중 소년(少年) 지에 시를 발표하며 정식으로 문단에 데뷔했다." +
"일본 유학 후 도시샤 대학 재학 중 , 1943년 항일운동을 했다는 혐의로 일본 경찰에 체포되어 후쿠오카 형무소(福岡刑務所)에 투옥, 100여 편의 시를 남기고 27세의 나이에 옥중에서 요절하였다. 사인이 일본의 생체실험이라는 견해가 있고 그의 사후 일본군에 의한 마루타, 생체실험설이 제기되었으나 불확실하다. 사후에 그의 시집 《하늘과 바람과 별과 시》가 출간되었다." +
"일제 강점기 후반의 양심적 지식인으로 인정받았으며, 그의 시는 일제와 조선총독부에 대한 비판과 자아성찰 등을 소재로 하였다. 그의 친구이자 사촌인 송몽규 역시 독립운동에 가담하려다가 체포되어 일제의 생체 실험으로 의문의 죽음을 맞는다. 1990년대 후반 이후 그의 창씨개명 '히라누마'가 알려져 논란이 일기도 했다. 본명 외에 윤동주(尹童柱), 윤주(尹柱)라는 필명도 사용하였다.";
// 언어 분석 기술(구어)
text += "네 안녕하세요 홍길동 교숩니다";
requestJson = {
"argument": {
"text": text,
"analysis_code": analysisCode
}
}
http = urllib3.PoolManager()
response = http.request(
"POST",
openApiURL,
headers={"Content-Type": "application/json; charset=UTF-8", "Authorization" : accessKey},
body=json.dumps(requestJson)
)
print("[responseCode] " + str(response.status))
print("[responBody]")
print(str(response.data,"utf-8"))
언어 분석 API 레퍼런스
다음은
파라미터에 대한 설명입니다.
Field 명 | 타입 | 필수 여부 | 설명 |
---|---|---|---|
access_key | String | ○ | API 사용을 위해 ETRI에서 발급한 사용자 API Key |
argument | Object | ○ | API 사용 요청 시 분석을 위해전달할 내용 |
analysis_code | String | ○ |
요청할 분석 코드로서 요청할 수 있는 분석 요청은 아래와 같음 형태소 분석 (문어/구어) : "morp", 어휘의미 분석 (동음이의어 분석)(문어) : "wsd" 어휘의미 분석 (다의어 분석)(문어) : "wsd_poly" 개체명 인식 (문어/구어) : "ner" 의존 구문 분석 (문어) : "dparse" 의미역 인식 (문어) : "srl" |
text | String | ○ | 분석할 자연어 문장으로서 UTF-8 인코딩된 텍스트만 지원 |
언어 분석 기술은 요청된 자연어 문장의 분석된 결과를 JSON 형태의
Text 데이터로 반환합니다. 분선된 결과는 입력된 analysis_code에 따라 의존성이 있는 분석 처리 결과를 포함하며,
포함되는 내용은 아래와 같습니다.
분석 명 | 분석 코드 | 포함되는 내용 |
---|---|---|
형태소
분속 (문어/구어) |
morp | 형태소 분석 결과 |
어휘의미
분석 (동음이의어) (문어) |
wsd | 형태소
분석 결과, 어휘의미 분석 결과 (동음이의어 분석) (동음이의어에 대한 상세정보 조회는 동음이의어 정보 API 사용) |
어휘의미
분석 (다의어 분석) (문어) |
wsd_poly | 형태소
분석 결과, 어휘의미 분석 결과 (다의어 분석) (다의어에 대한 상세정보 조회는 다의어 정보 API 사용) |
개체명
인식 (문어/구어) |
ner | 형태소 분석 결과, 어휘의미 분석 결과 (동음이의어 분석), 개체명 인식 결과 |
의존
구문 분석 (문어) |
dparse | 형태소 분석 결과, 어휘의미 분석 결과 (동음이의어 분석), 개체명 인식 결과, 의존 구문 분석 결과 |
의미역
인식 (문어) |
srl | 형태소 분석 결과, 어휘의미 분석 결과 (동음이의어 분석), 개체명 인식 결과, 의존 구문 분석 결과, 의미역 인식 결과 |
언어 분석 API의 형태소 분석은 TTA 표준 형태소 태그셋(TTAK.KO-11.0010/R1)에 기본하며, 구체적인 정보는 다음과 같습니다.
대분류 | 소분류 | 세분류 | 세종태그 |
---|---|---|---|
(1) 체언 | 명사 | 일반명사 | NNG |
고유명사 | NNP | ||
의존명사 | NNB | ||
대명사 | NP | ||
수사 | NR | ||
(2) 용언 | 동사 | VV | |
형용사 | VA | ||
보조용언 | VX | ||
지정사 | 긍정지정사 | VCP | |
부정지정사 | VCN | ||
(3) 수식언 | 관형사 | MM | |
부사 | 일반부사 | MAG | |
접속부사 | MAJ | ||
(4) 독립언 | 감탄사 | IC | |
(5) 관계언 | 격조사 | 주격조사 | JKS |
보격조사 | JKC | ||
관형격조사 | JKG | ||
목적격조사 | JKO | ||
부사격조사 | JKB | ||
호격조사 | JKV | ||
인용격조사 | JKQ | ||
보격조사 | JX | ||
접속조사 | JC | ||
(6) 의존형태 | 어미 | 선어말어미 | EP |
종결어미 | EF | ||
연결어미 | EC | ||
명사형전성어미 | ETN | ||
관형형전성어미 | ETM | ||
접두사 | 체언접두사 | XPN | |
접미사 | 명사파생접미사 | XSN | |
동사파생접미사 | XSV | ||
형용사파생접미사 | XSA | ||
어근 | XR | ||
(7) 기호 | 마침표, 물음표, 느낌표 | SF | |
쉼표, 가운뎃점, 콜론, 빗금 | SP | ||
따옴표, 괄호표, 줄표 | SS | ||
줄임표 | SE | ||
붙임표 (물결, 숨김, 빠짐) | SO | ||
외국어 | SL | ||
한자 | SH | ||
기타 기호 (논리 수학기호, 기호 등) | SW | ||
명사추정범주 | NF | ||
용언추정범주 | NV | ||
숫자 | SN | ||
분석불능범주 | NA |
언어 분석 API의 형태소 분석은 TTA 표준 형태소 태그셋(TTAK.KO-11.0010/R1)에 기본하며, 구체적인 정보는 다음과 같습니다.
대분류 | 세분류 | 정의 |
---|---|---|
PERSON (PS) | PS_NAME | 사람 이름 |
LOCATION (LC) | LC_OTHERS | LC계열의 세부 유형이 아닌 기타 장소 |
LCP_COUNTRY | 국가명 | |
LCP_PROVINCE | 도, 주 지역명 | |
LCP_COUNTY | 군, 면, 읍, 리, 동 등과 같은 세부 행정구역명 | |
LCP_CITY | 도시명 | |
LCP_CAPITALCITY | 수도명 | |
LCG_RIVER | 강, 호수, 연못 | |
LCG_OCEAN | 해양, 바다 | |
LCG_BAY | 반도, 만 | |
LCG_MOUNTAIN | 산, 산맥, 능선, 고개/재, 봉 | |
LCG_ISLAND | 섬, 제도 | |
LCG_CONTINENT | 대륙 | |
LC_TOUR | 관광명소 | |
LC_SPACE | 천체 명칭 | |
ORGANIZATION (OG) | OG_OTHERS | 기타 기관/단체 |
OGG_ECONOMY | 경제 관련 기관/단체, 기업 | |
OGG_EDUCATION | 교육 기관/단체, 교육관련 기관 | |
OGG_MILITARY | 군사 기관/단체 및 유형, 국방기관 | |
OGG_MEDIA | 미디어 기관/단체, 방송관련 기관/기업 | |
OGG_SPORTS | 스포츠 기관/단체 | |
OGG_ART | 예술 기관/단체 | |
OGG_MEDICINE | 의학/의료 기관/단체 | |
OGG_RELIGION | 종교 기관/단체, 종파 포함 | |
OGG_SCIENCE | 과학 기관/단체 | |
OGG_LIBRARY | 도서관 및 도서관 관련 기관/단체 | |
OGG_LAW | 법률 기관/단체 | |
OGG_POLITICS | 정부/행정 기관, 공공기관, 정치기관 | |
OGG_FOOD | 음식 관련 업체/회사 | |
OGG_HOTEL | 숙박 관련 업체 | |
ARTIFACTS (AF) | AF_CULTURAL_ASSET | 건물/서적/작품 등 문화재 |
AF_BUILDING | 건축물/토목건설물, 운동장이름, 아파트, 다리, 등대, 분수 | |
AF_MUSICAL_INSTRUMENT | 악기 명칭 | |
AF_ROAD | 도로/철로 명칭 | |
AF_WEAPON | 무기 명칭 | |
AF_TRANSPORT | 교통수단/자동차/선박 모델 및 유형, 운송 수단, 놀이기구 | |
AF_WORKS | AFW의 세부 작품명에 해당하지 않는 기타 작품명 | |
AFW_DOCUMENT | 도서/서적 작품명 | |
지리서, 지도 | ||
의학 관련 서적 | ||
종교 서적, 각 종교의 경전 | ||
철학 관련 서적 | ||
시/소설/희곡 등의 문학 작품명 | ||
역사 서적 | ||
기타 서적 | ||
AFW_PERFORMANCE | 춤/무용 작품명 및 춤 종류 | |
연극/공연명/가극 | ||
AFW_VIDEO | 영화 작품명 | |
TV 프로그램 이름 | ||
AFW_ART_CRAFT | 미술 작품명(그림/미술품) | |
AFW_MUSIC | 음악 작품명 | |
AF_WARES | 상품/제품 이름 | |
DATE (DT) | DT_OTHERS | DT 계열의 세부 유형이 아닌 기타 날짜 |
DT_DURATION | 기간 | |
DT_DAY | 날짜/절기 | |
DT_MONTH | 달 | |
DT_YEAR | 년 | |
DT_SEASON | 계절 | |
DT_GEOAGE | 지질시대 | |
DT_DYNASTY | 왕조시대 | |
TIME (TI) | TI_OTHERS | 기타 시간 |
TI_DURATION | 기간 | |
TI_HOUR | 시각 | |
TI_MINUTE | 분 | |
TI_SECOND | 초 | |
CIVILIZATION (CV) | CV_NAME | 문명/문화 명칭 |
CV_TRIBE | 민족/종족 명칭, 국가를 구성하는 국민 | |
CV_SPORTS | 스포츠/레포츠/레져 명칭 | |
CV_SPORTS_INST | 스포츠 용품/도구 | |
CV_POLICY | 제도/정책 명칭 | |
CV_TAX | 조세 명칭 | |
CV_FUNDS | 연금, 기금, 자금, 펀드 명칭 | |
CV_LANGUAGE | 언어 명칭 | |
CV_BUILDING_TYPE | 건축양식 명칭 | |
CV_FOOD | 음식 명칭, 음식재료 | |
CV_DRINK | 음료수, 술 명칭 | |
CV_CLOTHING | 의복/섬유 명칭 | |
CV_POSITION | 직위/직책 명칭, 스포츠 포지션 | |
CV_RELATION | 인간 관계 명칭 | |
CV_OCCUPATION | 직업 명칭 | |
CV_CURRENCY | 통화 명칭 | |
CV_PRIZE | 상과 훈장 | |
CV_LAW | 법/법률 명칭 | |
CV_FOOD_STYLE | 음식 종류 | |
ANIMAL (AM) | AM_OTHERS | 기타 동물 명칭 |
AM_INSECT | 곤충 | |
AM_BIRD | 조류 | |
AM_FISH | 어류 | |
AM_MAMMALIA | 포유류 | |
AM_AMPHIBIA | 양서류 | |
AM_REPTILIA | 파충류 | |
AM_TYPE | 동물 분류 명칭 | |
AM_PART | 동물 몸의 한 부분(신체 부위) 명칭 | |
PLANT (PT) | PT_OTHERS | 기타 식물 명칭 |
PT_FRUIT | 과일 이름 (식용 가능한 식물의 열매) | |
PT_FLOWER | 꽃 이름 | |
PT_TREE | 나무 이름 | |
PT_GRASS | 풀 이름 | |
PT_TYPE | 식물 유형 명칭 | |
PT_PART | 식물의 한 부분에 대한 명칭 | |
QUANTITY (QT) | QT_OTHERS | 기타 수량 표현 |
QT_AGE | 나이 | |
QT_SIZE | 크기/넓이 | |
QT_LENGTH | 길이/거리/높이 | |
QT_COUNT | 개수/빈도 | |
QT_MAN_COUNT | 인원수 | |
QT_WEIGHT | 무게 | |
QT_PERCENTAGE | 백분율, 비율, 농도 | |
QT_SPEED | 속도 | |
QT_TEMPERATURE | 온도 | |
QT_VOLUME | 부피 | |
QT_ORDER | 순서, 순차적 표현 | |
QT_PRICE | 금액 | |
QT_PHONE | 전화번호 | |
QT_SPORTS | 스포츠 관련 수량 표현 | |
QT_CHANNEL | TV/라디오 채널 번호 | |
QT_ALBUM | 앨범 관련 수량 표현 | |
QT_ZIPCODE | 우편번호 | |
STUDY_FIELD (FD) | FD_OTHERS | 학문 분야 및 학파 |
FD_SCIENCE | 과학 학문 분야 | |
FD_SOCIAL_SCIENCE | 사회과학 학문 분야 및 학파 | |
정치/경제/사회와 관련된 분야 | ||
FD_MEDICINE | 의학 관련 학문 분야 및 분과 | |
FD_ART | 예술관련 학문 분야 및 학파 | |
FD_PHILOSOPHY | 철학 관련 학문 분야 및 학파 | |
THEORY (TR) | TR_OTHERS | 기타 이론/법칙/원리 |
TR_SCIENCE | 과학 관련 이론/법칙/방식/양식/체계/학설 | |
TR_SOCIAL_SCIENCE | 사회과학 이론/법칙/방법/원리/사상, 정치사상 | |
TR_ART | 예술관련 이론/법칙/방식/양식, 예술사조 | |
TR_PHILOSOPHY | 철학 이론/사상 | |
TR_MEDICINE | 의학 요법/처방, 의학 진단법 | |
EVENT (EV) | EV_OTHERS | 기타 사건/사고 명칭, ~사태 |
EV_ACTIVITY | 사회운동 및 선언 | |
EV_WAR_REVOLUTION | 전쟁/혁명 | |
EV_SPORTS | 스포츠/레저 관련 행사 | |
EV_FESTIVAL | 축제 명칭 | |
MATERIAL (MT) | MT_ELEMENT | 원소명 |
MT_METAL | 금속물 | |
MT_ROCK | 암석 명칭 | |
MT_CHEMICAL | 모든 화학물질을 나타냄 | |
TERM (TM) | TM_COLOR | 색 |
TM_DIRECTION | 방향 | |
TM_CLIMATE | 기후지역 명칭 | |
TM_SHAPE | 모양/형태 명칭 | |
TM_CELL_TISSUE | 세포/조직/기관 명칭 (외부에서 안 보이는 조직/기관) | |
TMM_DISEASE | 증상/증세/질병 | |
TMM_DRUG | 약/약품명 | |
TMI_HW | IT 하드웨어 용어 | |
TMI_SW | IT 소프트웨어 용어 | |
TMI_SITE | URL 주소 | |
TMI_EMAIL | 이메일주소 | |
TMI_MODEL | 각종 제품의 세부 모델명, 부품류 | |
TMI_SERVICE | IT 서비스 용어 | |
TMI_PROJECT | 프로젝트 명칭 | |
TMIG_GENRE | 게임 장르 | |
TM_SPORTS | 스포츠/레저 용어 (기술/규칙 명칭) |
구문 레이블 | 설명 | 기능 레이블 | 설명 |
---|---|---|---|
S | 문장 | SBJ | 주격 |
NP | 명사구 | OBJ | 목적격 |
VP | 동사구 | MOD | 관형격 수식어 |
AP | 부사구 | AJT | 부사격 수식어 |
VNP | 명사+이다 (지정사) | CNJ | 연결 (~와) |
DP | 관용사구 | CMP | 보격 |
IP | 감탄사 | INT | 독립어 |
기타 표지 | 설명 |
---|---|
PRN | 삽입어구 |
X | pseudo phrase |
L, R | 부호 |
Q | 인용절 |
의미역 인식에서 사용하는 의미역은 필수역(core role)과 부가역(adverbal role)으로 구분되며, Proposition Bank[2]에서 정의된 세부적인 목록은 다음과 같습니다.
타입 | 의미역 | 설명 |
---|---|---|
필수격 | ARG0 (A0) | 행동주(Agent), 경험주(experiencer) |
ARG1 (A1) | 피동주(Patient), 대상(theme) | |
ARG2 (A2) | 수혜자(Benefactive), instrument, attribute, | |
결과(end state) | ||
ARG3 (A3) | 기점(Start point), benefactive, instrument, attribute | |
ARG4 (A4) | 착점(End point) | |
부가격 | ARGM-TMP | 시간(When) |
ARGM-LOC | 장소(Where) | |
ARGM-DIR | 방향(where to/from) | |
ARGM-MNR | 방법(How, manner) | |
ARGM-PRP | 목적 | |
ARGM-CAU | 원인 | |
ARGM-EXT | 범위, 정도 | |
ARGM-CND | 조건 | |
ARGM-PRD | 보조서술 | |
ARGM-DIS | 담화 | |
ARGM-ADV | 부사구 | |
ARGM-NEG | 부정 |
언어 분석 API의 오류 코드 목록은 다음과 같습니다.
http status code | result | reason | 설명 |
---|---|---|---|
403 | -1 | Empty Auth Header | Authorization 헤더가 없는 경우 |
403 | -1 | Invalid Key | KEY
API 키가 없는 경우 |
403 |
-1 | Blocked KEY | API
키가 관리자에 의해서 차단된 경우 |
403 |
-1 | Daily Limit Exceeded | 일간 호출 제한에 걸린 경우 |
403 |
-1 | Monthly
Limit Exceeded |
월간 호출 제한에 걸린 경우 |
403 |
-1 | Yearly
Limit Exceeded |
연간 호출 제한에 걸린 경우 |
403 |
-1 | Too Many Keys | 같은 IP에서 여러 API 키가 사용된 경우 |
403 |
-1 | Too Many IPs | 하나의 API 키를 여러 IP 에서 사용한 경우 |
403 |
-1 | Not Allowed IP | API
호출 가능한 IP 가 아닌경우 (API 설정에서 허용된 IP가 아닌경우) |
403 |
-1 | Not Allowed Subpath | 하위경로 접근 제한이 되어 있는 경우 |
403 | -1 | Invalid
API |
등록되지
않은 API를 요청한 경우 |
408 | -1 |
Request
Timeout |
서버의
요청 대기가 시간을 초과한 경우 |
413 |
-1 | Body
Size Limit Exceeded |
요청
바디가 설정된 값보다 큰 경우 |
429 |
-1 | Concurrent
Limit Exceeded |
연속호출
허용 범위를 넘어서 호출한 경우 |
500 | -1 | Internal Server Error | 내부 오류 발생한 경우 |