API Key 发行
POST/issue_service_authorization
发行 API key。
必须指定sid和spw的组合,或authorization(在Authorization header 中指定的 API key)二者之一。
警告
请将sid和spw以application/x-www-form-urlencoded格式设置在请求体中。请不要通过查询参数(在 URL 末尾加?进行指定的方法)指定。
警告
服务密码与用于登录 MyPage 的密码不同。
警告
即使 serviceId 或 service 密码错误,也会发行 API key。使用此无效的 API key 连接语音识别服务时,将会出现认证错误。错误消息因接口而异。
HTTP 接口的情况
如果 Service ID 或 Service Password 中有一个错误,将返回以下错误:
{
"code":"-",
"message":"received illegal service authorization"
}
WebSocket 接口的情况
如果 Service ID 或 Service Password 中有一个错误,将返回以下错误:
s can't validate service authorization
请求
响应
- 200
- 400
返回 API key 字符串。
失败时返回错误消息。
| 错误消息 | 错误情况 |
|---|---|
| Invalid Authorization Header | Authorization header 不以 Bearer 开头时 |
| Invalid appkey | 在authorization中指定的 API key 不正确时(无法认证 API key) |
| Dont issue appkey | 在authorization中指定的 API key 未设置为"Issuable",或已被禁用时 |
如果没有任何响应,可能是必要项目未指定,请检查参数。