작업 상태 확인, 결과 가져오기

GET /v2/recognitions/:session_id

지정한 음성 인식 작업의 상태와 결과를 취득합니다.

요청

응답

음성 인식 요청의 상태 status와 부수적인 정보를 반환합니다. status는 다음 5가지 값을 가집니다.

status	설명
queued	작업이 큐에 등록된 상태.
started	작업이 큐에서 꺼내져 실행 환경을 준비하고 있는 상태.
processing	작업이 실행되고 있는 상태.
completed	음성 인식 프로세스에서 결과를 얻은 상태. `code`가 빈 문자열, 즉 음성 인식에 성공한 경우 `segments`에 결과가 포함됩니다.
error	작업을 실행하려고 할 때 또는 작업 실행 중에 어떤 오류가 발생한 상태. `error_message`에 오류의 상세 내용을 저장합니다.

queued, started, processing, completed, error의 각 상태에서 포함되는 정보에 대해 다음 표에 정리합니다. 각 상태의 각 머리글자 열(q, s, p, c, e)에서 A로 표시된 것은 항상 포함됩니다. O로 표시된 것은 해당 정보가 있으면 응답에 포함됩니다.

Key	q	s	p	c	e	설명
status	A	A	A	A	A	작업의 상태. queued, started, processing, completed, error 상태를 가집니다.
audio_md5			A	A	O	수신한 음성 파일의 MD5 체크섬 값.
audio_size			A	A	O	수신한 음성 파일의 크기.
content_id	O	O	O	O	O	사용자가 요청 시 설정한 contentId 값.
service_id	A	A	A	A		서비스 ID.
segments				A		발화 단위의 음성 인식 결과.
utteranceid				A		인식 결과 정보 ID.
text				A		'발화 구간의 인식 결과' 모두를 연결한 전체 인식 결과 텍스트.
code				A		결과를 나타내는 1문자 코드.
message				A		오류 내용을 나타내는 문자열.
error_message					A	오류 내용을 나타내는 문자열

status가 completed일 때는 음성 인식의 결과를 JSON 형식으로 반환합니다. 동기 HTTP 인터페이스와 달리 인식 결과가 발화 단위로 segments 아래에 배치됩니다.

인증에 실패한 경우 반환됩니다.

오류 메시지	오류 상황
No authorization header	Authorization 헤더가 설정되지 않음
Invalid authorization header format	Authorization 헤더의 형식이 잘못됨
Failed to authorize for the API key	지정된 API key로 인증 실패

지정된 session_id의 작업을 찾을 수 없는 경우 반환됩니다.

오류 메시지	오류 상황
Specified session_id is not found	지정된 `session_id`의 작업을 찾을 수 없음

올바른 session_id를 지정했음에도 이 오류가 발생하는 경우, 다음과 같은 경우가 고려될 수 있습니다.

데이터 보존 기간이 지났을 때
요청 시 사용자와 다른 사용자가 작업 상태나 결과를 가져오려고 할 때

작업 상태 확인, 결과 가져오기

/v2/recognitions/:session_id

요청​

응답​

요청

응답