API Key Issuance
POST/issue_service_authorization
Issues an API key.
Either authorization (an API key specified in the Authorization header), or the pair of sid and spw is required.
Please set sid and spw in the request body in application/x-www-form-urlencoded format. Do not specify them as query parameters (appended to the end of the URL after ?).
- The service password is different from the password used to log in to MyPage.
- For accounts created after the MyPage renewal on 2025/06/30, the service ID and service password are not displayed on MyPage. Please use an API key issued with the API key issuance functionality enabled as
authorization.
Even if the Service ID or Service Password is incorrect, an API key will be issued. If you use this invalid API key to connect to the speech recognition service, an authentication error will occur. The error message may vary depending on the interface.
In case of HTTP interface
If either the Service ID or Service Password is incorrect, it will return the following error:
{
"code":"-",
"message":"received illegal service authorization"
}
In case of WebSocket interface
If either the Service ID or Service Password is incorrect, it will return the following error:
s can't validate service authorization
Request
Responses
- 200
- 400
Returns the API key string.
On failure, returns an error message.
| Error Message | Error Situation |
|---|---|
| Invalid Authorization Header | When the Authorization header does not start with Bearer |
| Invalid appkey | When the API key specified in authorization is incorrect (authentication of the API key fails) |
| Dont issue appkey | When the API Key specified in authorization is not set to "Issuable" or is disabled |
If there is no response, required items may not have been specified, so please check the parameters.