메인 콘텐츠로 건너뛰기

원타임 APPKEY 발행

원타임 APPKEY를 발행하기 위한 엔드포인트를 제공합니다. 마이페이지에 기재된 서비스 ID와 서비스 비밀번호로 원타임 APPKEY를 발행할 수 있습니다.

  • APPKEY는 애플리케이션이 AmiVoice API 음성 인식 서비스를 이용하기 위한 서비스 인증 키 문자열입니다.
  • 원타임 APPKEY는 마이페이지에 기재된 [APPKEY]와 동일한 기능을 가진 서비스 인증 키 문자열이지만, 발행 일시와 유효 시간에 기반한 유효 기간 일시가 설정되어 있다는 점이 다릅니다.

엔드포인트​

POST https://acp-api.amivoice.com/issue_service_authorization

요청​

요청 파라미터​

파라미터명
필수
설명
sid●마이페이지의 접속 정보에 표시되는 서비스 ID를 지정합니다
spw●마이페이지의 접속 정보에 표시되는 서비스 비밀번호를 지정합니다.
epi유효 기간. 발행할 원타임 APPKEY의 사용 기한을 지정합니다. 생략 시 30000(30초)로 설정됩니다.
ipa접속 IP 주소. 원타임 APPKEY를 사용할 수 있는 클라이언트의 IP 주소에 제한을 둘 수 있습니다
노트

서비스 비밀번호와 마이페이지 로그인용 비밀번호는 다릅니다.

유효 기간​

다음 중 하나를 지정할 수 있습니다.

  • 숫자. 밀리초 단위의 사용 기한이 됩니다.
  • 's' (초), 'm' (분), 'h' (시간), 'd' (일), 'w' (주)를 단위로 하는 문자열. 예를 들어, 다음과 같이 지정할 수 있습니다.
5m                  5분
2h                  2시간
100d                100일
  • yyyy(/|-)mm(/|-)dd[( |T)hh:mm:ss[.sss][[ ](Z|(+|-)zz[[:]zz])]] 형식의 시간을 나타내는 문자열. 예를 들어, 다음과 같이 지정할 수 있습니다.
2021/06/30            2021년 6월 30일 24시 0분 0초 (2021년 7월 1일 0시 0분 0초)까지 유효
2021/07/00            2021년 6월 30일 24시 0분 0초 (2021년 7월 1일 0시 0분 0초)까지 유효
2021/05/15 12:05:30   2021년 5월 15일 12시 5분 30초까지 유효

접속 IP 주소​

다음 중 하나를 지정할 수 있습니다.

  • 빈 문자열
  • 공백 또는 , (쉼표)를 구분자로 하는 여러 개의 IPv4 CIDR 형식의 IP 주소를 나타내는 문자열. 예를 들어, 다음과 같이 지정할 수 있습니다.
10.1.2.34
192.168.0.0/16
150.249.206.220 150.249.236.100/31

응답​

성공 시​

원타임 APPKEY 문자열을 반환합니다.

실패 시​

아무것도 반환하지 않습니다. 필수 항목이 지정되지 않았을 가능성이 있으므로 쿼리 파라미터를 확인하십시오.

주의

서비스 ID나 서비스 비밀번호가 잘못되어 있어도 원타임 APPKEY가 발행됩니다. 이 잘못된 원타임 APPKEY를 사용하여 음성 인식 서비스에 연결하면 인증 오류가 발생합니다. 오류 메시지는 인터페이스 등에 따라 다릅니다.

HTTP 인터페이스의 경우​

서비스 ID, 서비스 비밀번호 중 어느 하나가 잘못된 경우, 타이밍에 따라 다음 중 하나의 오류를 반환합니다.

{
    /* ... 생략 ... */
    "code":"!","message":"failed to connect to recognizer server"
}
{
    /* ... 생략 ... */
    "code":">","message":"failed to send audio data to recognizer server"
}

WebSocket 인터페이스의 경우​

서비스 ID가 잘못된 경우에는 s 명령어가 실패합니다. 이때 s 명령어 응답으로 다음과 같이 오류를 반환합니다.

s can't connect to recognizer server

서비스 ID에 대해 서비스 비밀번호가 잘못된 경우에는 s 명령어는 성공합니다. 그러나 실제로 p 명령어로 음성을 전송하면 음성 인식에 실패했을 때의 오류를 반환합니다.

{
    /* ... 생략 ... */
    "code":"!","message":"failed to connect to recognizer server"
}

또한, p 명령어에 대해 다음 오류도 반환합니다.

p can't feed audio data to recognizer server