文档首页/ 云客服/ API参考/ 接口鉴权方式/ C7 轻量级座席工作台页面Oauth2.0接口鉴权方式
更新时间:2025-11-13 GMT+08:00
分享

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

响应消息描述

表4 result参数说明

序号

名称

参数类型

是否必选

说明

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"
    }

相关文档