# 查询热词表信息 - ShowVocabulary
#### 功能介绍
通过热词表id查询热词表的信息和内容。详细使用指导请参见[SIS服务使用简介](https://support.huaweicloud.com/qs-sis/sis_07_0001.html)章节。
#### 调试
您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=SIS&api=ShowVocabulary)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/usermanual-sis/sis_09_0016.html)。
#### URI
GET /v1/{project_id}/asr/vocabularies/{vocabulary_id}
表1路径参数 
| 参数            | 是否必选 | 参数类型   | 描述                                                                               |
|:---|:---|:---|:---|
| project_id    | 是    | String | 项目编号。获取方法，请参见[获取项目ID](https://support.huaweicloud.com/api-sis/sis_03_0008.html)。 |
| vocabulary_id | 是    | String | 被查询的热词表id。                                                                       |
   
#### 请求参数
表2请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                                                                                                                        |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | 用户Token。 用于获取操作API的权限。获取方法请参见[认证鉴权](https://support.huaweicloud.com/api-sis/sis_03_0058.html)。响应消息头中X-Subject-Token的值即为Token。 |
   
#### 响应参数
**状态码： 200**
表3响应Body参数 
| 参数            | 是否必选 | 参数类型             | 描述                       |
|:---|:---|:---|:---|
| vocabulary_id | 是    | String           | 调用成功返回热词表ID，调用失败时无此字段。   |
| name          | 是    | String           | 调用成功返回热词表名，调用失败时无此字段。    |
| language      | 是    | String           | 调用成功返回热词表语言类型，调用失败时无此字段。 |
| description   | 是    | String           | 调用成功返回热词表描述，调用失败时无此字段。   |
| contents      | 是    | Array of strings | 调用成功返回热词列表，调用失败时无此字段。    |
   
**状态码： 400**
表4响应Body参数 
| 参数         | 参数类型   | 描述                     |
|:---|:---|:---|
| error_code | String | 调用失败时的错误码。 调用成功时无此字段。  |
| error_msg  | String | 调用失败时的错误信息。 调用成功时无此字段。 |
   
#### 请求示例
![](https://support.huaweicloud.com/api-sis/public_sys-resources/note_3.0-zh-cn.png)
"endpoint"即调用API的请求地址，不同接口不同区域的"endpoint"不同，具体请参见[终端节点](https://support.huaweicloud.com/api-sis/sis_03_0004.html)。
- 查询热词表信息
  ```
  GET https://{endpoint}/v1/{project_id}/asr/vocabularies/{vocabulary_id}
  Request Header:
  Content-Type: application/json
  X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG...
  ```
  
 
#### 响应示例
**状态码： 200**
成功响应示例
```
{ 
  "vocabulary_id": "CFD08A32-6176-4ad7-92F9-11ED015C8109",
  "name": "telepower",
  "description": "telepower 具体描述",
  "language": "chinese_mandarin", 
  "contents": ["示例"]
}
```
**状态码：400**
失败响应示例
```
{ 
    "error_code":"SIS.0201", 
    "error_msg":"***" 
}
```
#### 状态码
状态码请参见[状态码](https://support.huaweicloud.com/api-sis/sis_03_0044.html)。
#### 错误码
错误码请参见[错误码](https://support.huaweicloud.com/api-sis/sis_03_0045.html)。