メインコンテンツまでスキップ

ユーザー登録単語用クラス名

ユーザー登録単語用クラス名一覧を取得します。

エンドポイント​

GET https://acp-api.amivoice.com/classnames/<dgn>

認証​

APPKEY はAuthorizationヘッダーに指定してください。

Authorization: Bearer {APPKEY}

リクエストパラメータ​

パラメータ名
パラメータ名
注記
dgn接続エンジン名-a-generalなどの接続エンジン名を指定します。指定できる値は音声認識エンジンの一覧を参照してください。パスパラメータとして設定します。
adf音声データ形式16kまたは8kのいずれかを指定します。指定しない場合は16kとなります。音声認識エンジンによっては複数のサンプリングレートに対応していますが、単語登録は8k、16kでそれぞれ異なるエンジンとしてとりあつかうためにどちらかを指定する必要があります。クエリパラメータとして設定します。

レスポンス​

成功時​

HTTPステータスコード: 200 OK

レスポンスボディ

フィールド名
説明
補足
classnamesクラス名クラス名が配列形式で得られます

例

{
    "classnames":
        [
            "固有名詞",
            "名前",
            "名前(名)",
            "駅名",
            "地名",
            "会社名",
            "部署名",
            "役職名",
            "記号",
            "括弧開き",
            "括弧閉じ",
            "元号"
        ]
}

失敗時​

HTTPステータスコード: 200以外

レスポンスボディ

フィールド名
説明
補足
codeエラーコードエラーの種別を示すコード
messageエラーメッセージエラー内容の詳細を説明するテキスト

エラーコードとエラーメッセージ

HTTPステータスコード
レスポンスボディエラーの状況
404 Not Found{"code":"?","message":"missing dictation grammar file name"}ディクテーショングラマファイル名 <dgn> が指定されていない時
405 Method Not Allowed{"code":"?","message":"POST method is not allowed"}POST が指定された時
401 Unauthorized{"code":"-","message":"can't verify service authorization"}サービス認証キー文字列の認証に失敗した時
401 Unauthorized{"code":"-","message":"service authorization has expired: <expirationTime> (<expiresIn>)"}サービス認証キー文字列の認証に失敗した時
500 Internal Server Error{"code":"?","message":"unexpected exception occurred (<optionalMessage>)"}想定外の例外が発生した時

例

{
    "code":"?",
    "message":"missing dictation grammar file name"
}