# C6 智能助手平台AppCube接口鉴权方式
#### 场景描述
智能助手平台提供接口给AppCube系统接入时，需要先调用获取token接口获取token以及token有效期，在后面调用的业务接口中携带token，如果token有效期过期需要重新调用获取token接口。
#### 接口方法
该接口仅支持POST方法，不支持PUT、GET和DELETE等方法。
#### 接口URI
https://IP:PORT/oifde/rest/appcube/api/getAppCubeToken
#### 请求说明
表1请求头参数 
| 序号 | 名称           | 参数类型   | 是否必选 | 说明                                  |
|:---|:---|:---|:---|:---|
| 1  | Content-Type | String | True | 固定填 application/json;charset=UTF-8。 |
   
表2请求体参数 
| 参数名称      | 数据类型   | 参数位置 | 必选/可选 | 描述                  |
|:---|:---|:---|:---|:---|
| appKey    | String | body | True  | APP标识，取值为租户ID。      |
| appSecret | String | body | True  | APP密钥，需要双方约定，可动态变更。 |
   
![](https://support.huaweicloud.com/api-ccfs-cec/public_sys-resources/note_3.0-zh-cn.png)
如何获取"appKey"和"appSecret"？
1. 与AppCube系统对接，需要使用租户id来获取token，在token有效期内完成调用操作，而且后续每一次接口调用都需要传入获取的token（对接AppCube系统时，接口的请求消息体中请携带authToken）。
   - "appKey"：为您所在的租户ID，您可在登录租间后，使用浏览器的开发工具查看Cookies，获取"TenantId"的值。
   
   - "appSecret"：为智能IVR下的"系统管理 \> 系统设置"，在API口令设置下设置的API口令。
    
 
![](https://support.huaweicloud.com/api-ccfs-cec/figure/zh-cn_image_0000002038127321.png "点击放大")
#### 响应说明
| 参数名称       | 数据类型   | 参数位置 | 必选/可选 | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
|:---|:---|:---|:---|:---|
| errorCode  | int    | body | True  | 错误码 - 0：成功  - 非0表示失败 或可通过状态码为200判断为成功    |
| errorMsg   | String | body | False | 错误描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| authToken  | String | body | True  | 认证token                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| expireTime | int    | body | False | 令牌有效期，单位是秒数，默认 3600 秒； 错误码非0时，无返回。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
   
#### 报文样例
- 请求消息体
  ```
  {
     "appKey": "tenant001",
     "appSecret": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" 
  }
  ```
  
- 响应消息体
  ```
  {
      "errorCode" : 0, // int, 错误码,无错时为0 
      "errorMsg" : "", // String, 出错信息,无错时为空
      "authToken": "2************************", 
      "expireTime" : 3600
  }
  ```