사용자 사전의 단어 등록

POST 
/profilewords/:dgn/:pid

지정한 음성 인식 엔진과 프로파일 ID의 사용자 사전의 단어를 교체할 수 있습니다.

요청 본문의 형식은 연결하는 엔진에 따라 다릅니다.

• 하이브리드 엔진: written(표기)과 spoken(읽기)으로 단어를 등록합니다. classname(클래스 이름)은 생략할 수 있습니다.
• End to End 엔진: written(표기)을 alternativewritten(대체 표기)으로 바꾸어 단어를 강조합니다. biasing(단어 강조도, 0 ~ 1, 기본값 0.5)으로 강조의 강도를 지정합니다.

End to End 엔진에서는 동일한 표기에 대해 복수 개의 대체 표기를 지정할 수 있습니다. 이때 동일한 표기의 단어에 대해서는 동일한 단어 강조도가 적용됩니다. 만약 요청 시 동일한 표기에 대해 서로 다른 단어 강조도를 지정한 경우, 요청 중 가장 먼저 나타나는 것의 단어 강조도 값이 채택됩니다. 예를 들어, 동일한 표기 "AMI"에 단어 강조도 0.8과 지정 없음의 2건을 지정한 경우, 가장 먼저 나타나는 것에 적용되는 값 "0.8"이 통일되어 적용됩니다.

요청

응답

200

등록된 단어 목록을 JSON 형식으로 반환합니다.

400

요청 본문이 올바르지 않을 때 반환됩니다.

응답 본문	오류 상황
{"code":"-","message":"missing request body"}	POST 메소드로 요청되었는데 요청 본문이 지정되지 않았을 때
{"code":"-","message":"invalid request body (<optionalMessage>)"}	요청 본문이 JSON으로서 올바르지 않을 때

401

API key(서비스 인증 키 문자열)의 인증에 실패했을 때 반환됩니다.

응답 본문	오류 상황
{"code":"-","message":"can't verify service authorization"}	API key의 인증에 실패했을 때
{"code":"-","message":"service authorization has expired: <expirationTime> (<expiresIn>)"}	API key의 유효기간이 만료되었을 때

404

경로 파라미터가 지정되지 않았을 때 반환됩니다.

응답 본문	오류 상황
{"code":"?","message":"missing dictation grammar file name"}	연결 엔진 이름 <dgn>이 지정되지 않았을 때
{"code":"?","message":"missing profile id"}	프로파일 ID <pid>가 지정되지 않았을 때

422

요청 본문에 지정된 JSON이 기대한 형식이 아닐 때 반환됩니다.

응답 본문	오류 상황
{"code":"?","message":"missing profile words"}	JSON이 기대한 형식이 아닐 때
{"code":"?","message":"invalid written: <written>"}	표기가 올바르지 않을 때
{"code":"?","message":"invalid spoken: <spoken>"}	읽기가 올바르지 않을 때
{"code":"?","message":"invalid class name: <className>"}	단어 클래스가 올바르지 않을 때
{"code":"?","message":"invalid alternative written: <alternativeWritten>"}	대체 표기가 올바르지 않을 때

500

예상치 못한 예외가 발생했을 때 반환됩니다.

응답 본문	오류 상황
{"code":"?","message":"unexpected exception occurred (<optionalMessage>)"}	예상치 못한 예외가 발생했을 때