# C7 座席工作台页面Oauth2.0接口鉴权方式
#### 场景描述
提供座席工作台页面Oauth2.0接口，接口调用需要携带授权码或刷新令牌和客户端ID。
#### 接口方法
该接口仅支持POST方法，不支持PUT、GET和DELETE等方法。
#### 接口URI
https://域名/apiaccess/CC-Management/v1/oauth/token，例如域名是service.besclouds.com
#### 请求说明
- 消息头
  表1消息头参数说明 
  | 序号 | 名称           | 参数类型   | 是否必选 | 说明                                          |
  |:---|:---|:---|:---|:---|
  | 1  | Content-Type | string | True | 消息主体编码方式，缺省值：application/json;charset=UTF-8 |
     
  
- 消息体
  表2消息体参数说明 
  | 序号 | 名称            | 参数类型   | 是否必选  | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
  |:---|:---|:---|:---|:---|
  | 1  | grant_type    | String | True  | 授权类型。 - authorization_code  - refresh_token   |
  | 2  | client_id     | String | True  | Client ID                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
  | 3  | client_secret | String | False | Client Secret。 "grant_type"配置为"authorization_code"时必须配置此参数。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
  | 4  | code          | String | False | 授权码。 "grant_type"配置为"authorization_code"时必须配置此参数。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
  | 5  | redirect_uri  | String | False | 访问的第三方应用的URL。 "grant_type"配置为"authorization_code"时必须配置此参数。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
  | 6  | refresh_token | String | False | 刷新令牌。 "grant_type"配置为"refresh_token"时必须配置此参数。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
     
  
 
#### 响应说明
表3消息体参数说明 
| 序号 | 名称         | 参数类型   | 是否必选  | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
|:---|:---|:---|:---|:---|
| 1  | result     | object | False | 结果内容对象。该对象参数说明请参见[表4]。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| 2  | returnCode | string | True  | 错误码。取值如下： - 0：成功  - 非0：失败   |
| 3  | returnDesc | string | True  | 响应消息描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
   
 表4result参数说明 
| 序号  | 名称            | 参数类型   | 是否必选 | 说明                                                                                                                                          |
|:---|:---|:---|:---|:---|
| 1.1 | access_token  | String | True | 认证token。                                                                                                                                    |
| 1.2 | token_type    | String | True | 令牌类型。 默认值为Bearer。                   |
| 1.3 | expires_in    | Int    | True | 令牌有效期，单位是秒数，默认3600秒； 错误码非0时，无返回。 |
| 1.4 | refresh_token | String | True | 刷新令牌。                                                                                                                                       |
| 1.5 | scope         | String | True | 固定read。                                                                                                                                     |
   
#### 报文样例
- 消息头
  ```
  Content-Type:application/json;charset=UTF-8
  ```
  
- 请求参数
  ```
  {
      "grant_type": "authorization_code",
      "client_id": "A32135A8293289C5AFD5F9CAAD4CE9E5",
      "client_secret": "kt6D8aLI9ryfcisc",
      "code": "nJ8QI9",
      "redirect_uri": "https://www.baidu.com"
  }
  ```
  
- 响应参数
  ```
  {
      "result": {
          "access_token": "eyJhbGciOiJSUzI1NiJ9.eyJpc3MiOiJBSUNDIiwic3ViIjoiMTcyNTYxMjY2ODk4NzEwOTE0NyIsInRlbmFudElkIjoiMjAyNDA4MDUwOTI1IiwiYXVkIjpbIkEzMjEzNUE4MjkzMjg5QzVBRkQ1RjlDQUFENENFOUU1Il0sImlhdCI6MTc0ODI0MzM5MSwiZXhwIjoxNzQ4MjQ2OTkxLCJqdGkiOiJlNjUyMzg1NS1mZmZkLTRhZTItOWE4NS01NWQwZDUwNTZlOTEifQ.Irw5TF_7LQIy9vCL7BmoZSqrWKkM5XDrZ897N0D8PMH2b3z3dHiKrzOB1H6O86ombADn4uWzrNL2715boDOVu4YRIIjqQHUVkmQH2_whT5xg00eIN4sDgfGkWM_x3FY5Ia_DqV24tZt6IowSUNUo3NMiq_426Af7rUaroHvuqJX-PqDg2LdpetPIYR3XR9WuMmkuybFk4zwcLH_dT3nN0LhPT1q3ABNXnxiSpFVGbDqyOLjQukIs4q0HGWhXQOdM6O5Bs6pzI3psATijBbhaQdQugqVfVZNPuRNRstaE6JJ9SCDeLGtGKrKCt0GAulIDs_cfUOyH47v_G2Gbi4y-iQ",
          "token_type": "Bearer",
          "expires_in": 3600,
          "refresh_token": "864ff2a5-02b0-4a7d-b085-84d76fc8ad8d",
          "scope": "read"
      },
      "returnCode": "0",
      "returnDesc": "success"
  }
  ```