文档首页/ 云客服/ API参考/ 监控类接口参考/ 接口说明/ 配置数据查询类接口/ 查询接入用户可访问的所有租户信息
更新时间：2025-11-13 GMT+08:00
查看PDF
分享

查询接入用户可访问的所有租户信息

场景描述

接入用户根据AKSK查询可访问的所有租户信息。

该接口只支持使用私有AKSK。

接口方法

设置成“POST”。该接口仅支持POST方法，不支持PUT、GET和DELETE等方法。

请求URL

https://ip:port/rest/cmsapp/v1/openapi/tenant/querytenants

其中，公有云环境请联系管理员获取，ip为CC-CMS服务器地址，port为CC-CMS服务器的HTTPS端口号。

非公有云环境如果配置了NSLB服务，ip请填写NSLB的服务器地址，port为CC-CMS服务在NSLB映射的HTTPS端口号。

请求说明

表1 请求头参数

序号

名称

参数类型

是否必选

说明

1

Content-Type

String

True

固定填 application/json; charset=UTF-8。

2

Authorization

String

True

生成方式参见C2 监控/系统外呼/话单/知识库类接口鉴权方式。
表2 消息体参数说明

参数名

数据类型

是否必选

说明

ccId

int

False

呼叫中心编号，取值范围：1～65535

  • 集成环境，默认值为系统管理员登录AICC系统后，通过“配置中心 > 系统管理 > CMS系统配置”查看的呼叫中心编号。若该配置为空，取值数据库t_cms_sysparam表中的sys_key="default_cc_id",sys_type="cms_system_config"对应的数据。
  • 独立部署环境，默认值为系统管理员登录AICC系统后，通过“配置中心 > 系统管理 > 参数配置”查看“默认呼叫中心标识”的值。

响应消息

表3 相应消息参数体说明

参数名

数据类型

说明

resultCode

string

查询结果。取值如下：

  • "0100000"：成功
  • 其他：失败

失败的原因说明请参见错误码参考。

resultDesc

array

查询成功后，返回结果信息的对象数组。

该数组中对象的参数说明请参见表4。
表4 resultDesc对象参数说明

参数名

数据类型

说明

ccId

int

呼叫中心编号。

tenantId

string

租间ID。

tenantSpaceName

string

租间名称。

vdnId

int

虚拟呼叫中心编号。

accessCodes

array

接入号列表。

该数组中对象的参数说明请参见表5。
表5 accessCodes 对象参数说明

参数名

数据类型

说明

accessCode

string

接入码。

isDefault

boolean

默认接入码标识，true:默认接入码，false或者空:非默认接入码。

样例报文

  • 请求头： 
    Content-Type: application/json;charset=UTF-8
Authorization: ******************
  • 请求参数： 
    {
 "ccId": 1
}
  • 响应参数： 
    {
    "resultCode": "0100000",
    "resultDesc": [
        {
            "ccId": 3,
            "vdnId": 47,
            "tenantId": "202008142460",
            "accessCodes": [
                {
                    "accessCode": "202008191",
                    "isDefault": true
                }
            ],
            "tenantSpaceName": "fjw081401"
        }
    ]
}