
# 认证Token信息接口
#### 场景描述
认证token信息接口，用于移动APP与APPCube对接场景。APPCube侧从移动APP侧拿到token后，需调用该接口解析token，获取用户信息打开APPCube页面。
#### 接口方法
POST
#### 接口URI
https://域名/apiaccess/rest/service-pub/authentication，例如域名是service.besclouds.com
#### 请求说明
表1请求体参数 
| 序号  | 名称          | 参数类型   | 是否必选 | 说明      |
|:---|:---|:---|:---|:---|
| 1   | requestBody | object | True | -       |
| 1.1 | token       | string | True | token信息 |
   
#### 响应说明
- **响应状态码: 200**
  表2响应体参数 
  | 序号    | 名称            | 参数类型   | 是否必选  | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
  |:---|:---|:---|:---|:---|
  | 1     | schema        | object | True  | 返回消息                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
  | 1.1   | returnCode    | string | True  | 返回码。 0：成功 1：token为空 2：token不合法 3：token过期 4：系统错误 |
  | 1.2   | returnMsg     | string | False | 描述信息                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
  | 1.3   | data          | object | False | 用户信息                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
  | 1.3.1 | userAccount   | string | False | 用户账号                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
  | 1.3.2 | userId        | string | False | 用户唯一标识                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
  | 1.3.3 | tenantId      | string | False | 租户唯一标识                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
  | 1.3.4 | tenantSpaceId | string | False | 租间标识                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
  | 1.3.5 | locale        | string | False | 语言信息                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
     
  
- **响应状态码: 400**
  错误的请求：请检查请求路径及参数
  
- **响应状态码: 401**
  未授权：1. 请确认是否购买了相关服务。 2. 请联系客服人员检查您账号的当前状态。
  
- **响应状态码: 403**
  鉴权失败
  
- **响应状态码: 404**
  请求的内容未找到：请检查请求的路径
  
- **响应状态码: 500**
  业务失败：请依次确认您请求中各参数的取值。
  
 
#### 错误码
无。
#### 报文样例
无请求头
请求参数:
```
{"token":"*********************"}
```
响应参数:
```
{
  "returnCode":"0",
  "returnMsg":"success",
  "data":{
     "userAccount":"xx",
         "userId":"xx",
         "tenantId":"xx",
         "tenantSpaceId":"xx",
         "locale":"zh_CN"
  }
}
```
