API キー発行
POST/issue_service_authorization
API キーを発行します。
sidとspwのペア、もしくはauthorization(Authorizationヘッダーに指定する API キー)のいずれかが必須です。
注意
sidとspwはリクエストボディにapplication/x-www-form-urlencoded形式で設定してください。クエリパラメータ(URL の末尾に?を付けて記載する方法)では指定しないでください。
注意
サービスパスワードとマイページへのログイン用のパスワードは異なります。
注意
サービス ID やサービスパスワードが間違っていても、API キーが発行されます。この不正な API キーを使用して音声認識サービスに接続すると、認証エラーになります。エラーメッセージはインタフェースによって異なります。
HTTPインタフェースの場合
サービス ID、サービスパスワードのいずれかが誤っている場合、以下のエラーを返します。
{
"code":"-",
"message":"received illegal service authorization"
}
WebSocketインタフェースの場合
サービス ID、サービスパスワードのいずれかが誤っている場合、以下のエラーを返します。
s can't validate service authorization
リクエスト
レスポンス
- 200
- 400
API キー文字列を返します。
失敗時はエラーメッセージを返します。
| エラーメッセージ | エラーの状況 |
|---|---|
| Invalid Authorization Header | AuthorizationヘッダーがBearer で始まらない場合 |
| Invalid appkey | authorizationで指定した API キーが正しくない場合(API キーの認証ができない) |
| Dont issue appkey | authorizationで指定した API キーが「API キー発行可能」と設定されていない場合、もしくは無効化されている場合 |
何もレスポンスが無い場合は、必須項目が指定されていない可能性がありますので、パラメータをチェックしてください。