Class Names for User-Registered Words

Retrieves a list of class names for user-registered words.

Endpoint

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

Authentication

Please specify the APPKEY in the Authorization header.

Authorization: Bearer {APPKEY}

Request Parameters

Parameter Name	Parameter Type	Notes
dgn	Connection engine name	Specify the connection engine name such as -a-general. For available values, please see List of Speech Recognition Engines. Set as a path parameter.
adf	Audio data format	Specify either 16k or 8k. If not specified, it defaults to 16k. Although some speech recognition engines support multiple sampling rates, word registration is treated as a different engine for 8k and 16k, so you need to specify one. Set as a query parameter.

Response

On Success

HTTP Status Code: 200 OK

Response Body

Field Name	Description	Additional Information
classnames	Class names	Class names are returned in array format

Example

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

On Failure

HTTP Status Code: Other than 200

Response Body

Field Name	Description	Additional Information
code	Error code	Code indicating the type of error
message	Error message	Text explaining the details of the error content

Error Codes and Error Messages

HTTP Status Code	Response Body	Error Situation
404 Not Found	{"code":"?","message":"missing dictation grammar file name"}	When the dictation grammar file name <dgn> is not specified
405 Method Not Allowed	{"code":"?","message":"POST method is not allowed"}	When POST is specified
401 Unauthorized	{"code":"-","message":"can't verify service authorization"}	When authentication of the APPKEY (service authentication key string) fails
401 Unauthorized	{"code":"-","message":"service authorization has expired: <expirationTime> (<expiresIn>)"}	When authentication of the APPKEY (service authentication key string) fails
500 Internal Server Error	{"code":"?","message":"unexpected exception occurred (<optionalMessage>)"}	When an unexpected exception occurs

Example

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