API Key 발급
POST/issue_service_authorization
API key를 발급합니다.
sid와 spw의 쌍 또는 authorization(Authorization 헤더에 지정하는 API key) 중 하나가 필수입니다.
주의
sid와 spw는 요청 본문에 application/x-www-form-urlencoded 형식으로 설정해 주십시오. 쿼리 파라미터(URL 끝에 ?를 붙여 기재하는 방법)로는 지정하지 마십시오.
주의
서비스 비밀번호와 마이페이지 로그인용 비밀번호는 다릅니다.
주의
서비스 ID나 서비스 비밀번호가 잘못되어 있어도 API key가 발급됩니다. 이 잘못된 API key를 사용하여 음성 인식 서비스에 연결하면 인증 오류가 발생합니다. 오류 메시지는 인터페이스에 따라 다릅니다.
HTTP 인터페이스의 경우
서비스 ID, 서비스 비밀번호 중 어느 하나라도 잘못된 경우, 다음 오류를 반환합니다.
{
"code":"-",
"message":"received illegal service authorization"
}
WebSocket 인터페이스의 경우
서비스 ID, 서비스 비밀번호 중 하나가 잘못된 경우, 다음과 같은 오류를 반환합니다.
s can't validate service authorization
요청
응답
- 200
- 400
API key 문자열을 반환합니다.
실패 시에는 오류 메시지를 반환합니다.
| 오류 메시지 | 오류 상황 |
|---|---|
| Invalid Authorization Header | Authorization 헤더가 Bearer 로 시작하지 않는 경우 |
| Invalid appkey | authorization으로 지정한 API key가 올바르지 않은 경우(API key의 인증이 불가능) |
| Dont issue appkey | authorization으로 지정한 API key가 'API キー発行可能' API key 발급 가능으로 설정되어 있지 않은 경우, 또는 비활성화된 경우 |
응답이 없는 경우 필수 항목이 지정되지 않았을 가능성이 있으므로 파라미터를 확인해 주십시오.