사용가이드

공통 설정

인증키 발급

인증 토근 발급받기 위한 계정 생성 이름, 이메일, 패스워드 입력 후 계정을 생성 해야만 정상적으로 사용이 가능합니다.

토큰 발급을 위한 로그인

이메일 / 패스워드 입력 토큰 값 발급 후 인증 통해 정상적으로 API 를 이용 하실 수 있습니다.

발급 토큰 유효

토큰은 발급 1시간 후 자동 파기 됩니다. 재 발급 받으셔야 정상 이용 가능하십니다.

형태소 분리

API URL

Method	Request URI
POST	/api/v1/analysis

요청 헤더

헤더명	설명
Authorization	로그인 또는 회원 가입 후 발급 받은 토큰키 입력 Bearer {토큰값}
Content-Type	application/json

요청 파라미터

name	type	desc	default	requirement
type	string	형태소 상세 처리 * detail - 상세 결과 확인 * normal - 일반 결과 확인	normal	N
nori	string	합성어 어근 분리 * yes - 백두산이 => 백두산 / 백두 / 산 / 이 * no - 백두산이 => 백두 / 산	no	N
static	string	형태소 카운트 * yes - 문장 형태소 반복 횟수 확인 * no - 카은트 하지 않음 기본	no	N
content	string	분석 Text 입력	N	Y

응답 바디

Field	Type	Desc
detail	Object	형태소 분석 결과
tokenizer	Object	토크나이저 문자열을 개별 텀들로 토큰화
tokens	Array of Object	토큰 정보 배열
tokens.token	String	토큰
tokens.start_offset	Integer	문자 시작 위치
tokens.end_offset	Integer	문자 종료 위치
tokens.type	String	토크나이저 타입
tokens.position	Integer	텀 순서
tokens.bytes	String	토크나이저 사이즈
tokens.leftPOS	String	품사 하단표 참조
tokens.morphemes	String
tokens.posType	String
tokens.positionLength	Integer	텀 길이
tokens.reading	String
tokens.rightPOS	String	품사 하단표 참조
tokens.termFrequency	Integer	텀 반복횟수
static	Object	형태소 반복 횟수 카운트

오류 코드

공통 오류

HttpStatusCode	ErrorCode	ErrorMessage	Description
400	100	Bad Request Exception	protocol(https), endocing(UTF-8) 등 request 오류
401	200	Authentication Failed	인증실패
401	210	Permission Denied	권한없음
404	300	Not Found Exception	권한없음
429	400	Quota Exceeded	Quota 초과
429	410	Throttle Limited	Rate 초과
429	420	Rate Limited	Rate 초과
413	430	Request Entity Too Large	content-length 초과 (10MB)
503	500	Endpoint Error	엔드포인트 연결오류
504	510	Endpoint Timeout	엔드포인트 연결시간 초과
500	900	Unexpected Error	예외처리가 안된 오류