
# 认证接口
#### 场景描述
用于接口认证。
#### 接口方法
设置成"POST"。
#### URL
/chatbot/serverauth/login
#### 请求参数
表1请求体参数 
| 名称       | 是否必选 | 参数类型   | 长度  | 说明                                             |
|:---|:---|:---|:---|:---|
| account  | True | String | 32  | 登录账号                                           |
| nonce    | True | String | 128 | 服务端提供的原始随机文本,来源于上一次业务请求返回401 unauthorized响应消息。 |
| checksum | True | String | 512 | 客户端根据nonce值及本地密钥使用HmacSHA256加密算法加密处理后的文本       |
   
#### 响应参数
| 名称       | 是否必选  | 参数类型   | 长度  | 说明                      |
|:---|:---|:---|:---|:---|
| token    | False | String | 128 | 认证成功必须返回,业务请求接口需要的token |
| duration | False | int    | 4   | 认证成功必须返回,token有效期（秒）    |
| error    | False | String | 512 | 认证失败时返回错误信息,同时状态码返回401。 |
| nonce    | False | String | 128 | 认证失败时返回,服务端随机生成的字符串。    |
   
#### 报文样例
- 请求样例
  ```
  {
  "account":"odfs",
  "nonce":"*******", // 服务端提供的原始随机文本
  "checksum":"0dbe11*******************0b505de" // 客户端根据nonce值及本地密钥使用HmacSHA256加密算法加密处理后的文本
  }
  ```
  
- 响应样例
  ```
  {
  "token":"2**************************d",
  "duration":3600
  }
  ```
  
 
