
# 使用API调用华为云CBS服务
本章节提供了通过Postman调用CBS服务问答机器人API的样例，帮助您零编码快速体验并熟悉CBS服务的使用方法。
使用CBS服务API的详细步骤如下所示：
[步骤1：配置环境]
[步骤2：Token认证鉴权]
[步骤3：调用服务]
#### 准备工作
- 已注册华为云账号，并完成实名认证，账号不能处于欠费或冻结状态。
- 已创建智能问答机器人。
 
 #### 步骤1：配置环境
1. 下载并安装Postman。 Postman建议使用7.24.0版本。
   
2. 下载问答机器人的Postman配置文件。 下载地址：[CBS_OpenApi.postman_collection.json](https://import-template.obs.cn-north-1.myhuaweicloud.com/CBS_OpenApi.rar)。
   
3. 导入配置文件。
   1. 打开并登录Postman。
   
   2. 单击左上角"File \> Import \> Import File \> Choose Files"导入配置文件。
      图1导入配置文件   
      ![](https://support.huaweicloud.com/qs-cbs/zh-cn_image_0000001168938654.png "点击放大")
      配置文件导入成功后，将显示在Postman左侧导航栏中。
      图2配置文件   
      ![](https://support.huaweicloud.com/qs-cbs/zh-cn_image_0000001169417142.png)
      ![](https://support.huaweicloud.com/qs-cbs/public_sys-resources/note_3.0-zh-cn.png)
      本配置文件中服务所属区域为"华北-北京四"，如果您在开通服务时，选择了其他区域，在执行步骤3、步骤4时请将配置文件中的所有"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/qs-cbs/zh-cn_image_0000001218166707.png "点击放大") 
3. 单击"Send"，发送请求，获取并复制Token。 获取返回结果"Headers"中的"X-Subject-Token"即为Token。Token有效期为24小时。
   图4获取Token   
   ![](https://support.huaweicloud.com/qs-cbs/zh-cn_image_0000001214421013.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/qs-cbs/zh-cn_image_0000001214782437.png "点击放大") 
4. 单击"Headers"配置项。将获取的Token复制到"X-Auth-Token"的参数值中。
   图6填写Token   
   ![](https://support.huaweicloud.com/qs-cbs/zh-cn_image_0000001214580963.png "点击放大") 
5. 单击"Body"配置项，修改配置文件内容。其中，question参数为必填项，其他参数项为非必填，其他参数请参见[请求参数](https://support.huaweicloud.com/api-cbs/cbs_03_0115.html#section3)。
   图7修改配置文件   
   ![](https://support.huaweicloud.com/qs-cbs/zh-cn_image_0000001172406854.png "点击放大") 
6. 单击"Send"，发送请求，获取调用结果。
   图8响应结果   
   ![](https://support.huaweicloud.com/qs-cbs/zh-cn_image_0000001214662491.png "点击放大") 
 
