# 调用API
在配置完问答语料、词典和模型训练后，您可以通过调用API的方式直接调用对话机器人，为您的客户提供问答服务。
问答机器人面向客户的问答界面需要您根据自己业务需求进行开发，前台界面收到客户问题后，调用问答机器人的接口，并与机器人进行交互，最终将问答机器人返回的答案呈现给客户。交互的过程中，问答机器人会基于知识库配置，对传入的客户问题进行搜索处理，并返回答案。
问答机器人中常用的接口如下所示，其他接口信息请参见[《问答机器人服务API参考》](https://support.huaweicloud.com/api-cbs/cbs_03_0013.html)。为您提供以下两种调用API接口的方法：
[使用Postman调用API]
[使用API Explorer调用API]
#### 准备工作
已注册华为账号并开通华为云，并完成实名认证，账号不能处于欠费或冻结状态。
 #### 使用Postman调用API
1. 配置环境。 
   1. 下载并安装Postman。 Postman建议使用7.24.0版本。
      
   
   2. 下载问答机器人的Postman配置文件。
   
   3. 导入配置文件。
      1. 打开并登录Postman。
      
      2. 单击左上角"File \> Import \> Import File \> Choose Files"导入配置文件。
         图1导入配置文件   
         ![](https://support.huaweicloud.com/usermanual-cbs/zh-cn_image_0000001166329880.png)
         配置文件导入成功后，将显示在Postman左侧导航栏中。
         图2配置文件   
         ![](https://support.huaweicloud.com/usermanual-cbs/zh-cn_image_0000001211574851.png)
         ![](https://support.huaweicloud.com/usermanual-cbs/public_sys-resources/note_3.0-zh-cn.png)
         本配置文件中服务所属区域为"华北-北京四"，如果您在开通服务时，选择了其他区域，在执行步骤2、步骤3时请将配置文件中的所有"cn-north-4"字段替换为实际区域，服务部署的区域具体请参见[终端节点](https://support.huaweicloud.com/api-cbs/cbs_03_0102.html)。
         
       
   
   
   
   
2. Token认证鉴权。 
   Token是用户的访问令牌，承载了用户的身份、权限等信息，用户调用API接口时，需要使用Token进行鉴权。
   1. 在Postman左侧导航栏中单击"get-token"配置文件。
   
   2. 单击"Body"配置项。填写用户名、密码、账号名。 请登录["我的凭证"](https://console.huaweicloud.com/iam/#/myCredential)页面，复制IAM用户名、账号名至username、domainname参数处，并填写密码。
      图3Token认证鉴权   
      ![](https://support.huaweicloud.com/usermanual-cbs/zh-cn_image_0000001166011372.png) 
   
   3. 单击"Send"，发送请求，获取并复制Token。 获取返回结果"Headers"中的"X-Subject-Token"即为Token。Token有效期为24小时。
      图4获取Token   
      ![](https://support.huaweicloud.com/usermanual-cbs/zh-cn_image_0000001211691259.png) 
   
   
   
   
3. 调用服务。 
   1. 在Postman左侧导航栏中单击"ExecuteQaChat"配置文件。
   
   2. 登录[我的凭证](https://console.huaweicloud.com/iam/#/myCredential)，获取"华北-北京四"区域的项目ID，替换配置文件URL中的{project_id}。
   
   3. 登录对话机器人服务管理控制台，在左侧菜单栏中选择"智能问答机器人"。在机器人列表，复制机器人ID，替换配置文件URL中的{qabot_id}。
      图5机器人ID   
      ![](https://support.huaweicloud.com/usermanual-cbs/zh-cn_image_0000001165851400.png) 
   
   4. 单击"Headers"配置项。将获取的Token复制到"X-Auth-Token"的参数值中。
      图6填写Token   
      ![](https://support.huaweicloud.com/usermanual-cbs/zh-cn_image_0000001165850752.png) 
   
   5. 单击"Body"配置项，修改配置文件内容。其中，question参数为必填项，其他参数项为非必填，其他参数请参见[请求参数](https://support.huaweicloud.com/api-cbs/cbs_03_0115.html#section3)。
      图7修改配置文件   
      ![](https://support.huaweicloud.com/usermanual-cbs/zh-cn_image_0000001211608715.png) 
   
   6. 单击"Send"，发送请求，获取调用结果。
      图8响应结果   
      ![](https://support.huaweicloud.com/usermanual-cbs/zh-cn_image_0000001166834470.png) 
   
   
   
   
 
 #### 使用API Explorer调用API
1. 进入[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=CBS&api=ExecuteQaChat)接口调试页面，以调用问答机器人API接口为例进行说明。
2. 在"对话机器人服务"页面中单击"问答机器人 \> ExecuteQaChat"。
3. 在问答机器人会话页面填写Region、Headers、Parameters、Body信息，其中带"\*"的为必填项。其他接口填写方法请参考API Explorer页面的在线文档，或参见[《问答机器人服务API参考》](https://support.huaweicloud.com/api-cbs/cbs_03_0013.html)。
   图9参数填写   
   ![](https://support.huaweicloud.com/usermanual-cbs/zh-cn_image_0000001166672318.png)
   表1参数填写说明 
   | 必填项        | 必填参数         | 描述                     | 填写方法                                                                                           |
   |:---|:---|:---|:---|
   | Region     | Region       | 可调用的地域。                | 单击![](https://support.huaweicloud.com/usermanual-cbs/zh-cn_image_0000001166672912.png)，选择区域名称。 |
   | Headers    | X-Auth-Token | 用户Token。               | 登录后会自动获取。                                                                                      |
   | Parameters | project_id   | 项目ID，用于资源隔离。           | 登录后会自动填充。                                                                                      |
   | Parameters | qabot_id     | 机器人标识符，qabot编号，UUID格式。 | 在机器人列表，复制机器人ID后填写。                                                                             |
   | Body       | question     | 用户问题。                  | 自定义填写。                                                                                         |
      
   
4. 参数填写完成后，单击"调试"。
5. 在"调试结果"页签查看响应结果。
   图10响应结果   
   ![](https://support.huaweicloud.com/usermanual-cbs/zh-cn_image_0000001211954599.png)