文档首页/ 云客服/ API参考/ 接口鉴权方式/ C6 智能助手平台AppCube接口鉴权方式
更新时间:2025-03-07 GMT+08:00

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密钥,需要双方约定,可动态变更。

如何获取“appKey”“appSecret”

  1. 与AppCube系统对接,需要使用租户id来获取token,在token有效期内完成调用操作,而且后续每一次接口调用都需要传入获取的token(对接AppCube系统时,接口的请求消息体中请携带authToken)。
    • “appKey”:为您所在的租户ID,您可在登录租间后,使用浏览器的开发工具查看Cookies,获取“TenantId”的值。
    • “appSecret”:为智能IVR下的系统管理 > 系统设置,在API口令设置下设置的API口令。

响应说明

参数名称

数据类型

参数位置

必选/可选

描述

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
    }