文档首页/云客服/API参考/监控类接口参考/接口说明/实时数据查询类接口/VDN维度实时接口/查询指定VDN下的系统接入码信息
更新时间：2025-11-13 GMT+08:00
查看PDF
分享

查询指定VDN下的系统接入码信息

场景描述

查询指定VDN下的系统接入码信息（VDN：虚拟呼叫中心，一个租户创建配置完毕后即对应一个虚拟呼叫中心）

关于系统接入码描述请参见《(For Engineer) ICD VxxxRxxxCxx 产品文档 01 (ICD)》

接口方法

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

请求URL

https://ip:port/rest/cmsapp/v1/openapi/vdn/queryaccesscodeinfo

其中，公有云环境请联系管理员获取，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 请求消息体参数说明

序号

名称

参数类型

是否必选

说明

1

ccId

int

True

呼叫中心编号。

取值范围：1～65535

2

vdn

int

True

虚拟呼叫中心编号。

取值范围：1～5000

响应说明

表3 响应消息体参数说明

序号

名称

参数类型

说明

1

result

String

查询结果。取值如下：

  • 0：成功
  • 其他：失败

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

说明：

当前字段为兼容8.13及其之前版本接口响应参数使用。

2

resultCode

string

查询结果。取值如下：

  • "0100000"：成功
  • 其他：失败
  • 失败的原因说明请参见错误码参考。

3

resultDatas

array

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

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

说明：

当前字段为兼容8.13及其之前版本接口响应参数使用。

4

resultDesc

array

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

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

表4 resultDesc/resultDatas对象参数说明

序号

名称

参数类型

说明

2.1

acId

int

接入码编号。

2.2

mediatypeId

int

媒体类型。该对象请参考表1

2.3

accessCode

String

接入码值

2.4

codeDescription

String

接入码描述

报文样例

  • 请求头： 
    Content-Type: application/json;charset=UTF-8
Authorization: ******************
  • 请求参数： 
    {
    "ccId":1, 
    "vdn":170
}
  • 响应参数： 
    {
    "result": "0",
    "resultCode": "0100000",
    "resultDatas": [
        {
            "acId": 289,
            "mediatypeId": 5,
            "accessCode": "650114",
            "codeDescription": "语音接入"
        },
        {
            "acId": 288,
            "mediatypeId": 5,
            "accessCode": "650115",
            "codeDescription": "语音接入"
        }
    ],
    "resultDesc": [
        {
            "acId": 289,
            "mediatypeId": 5,
            "accessCode": "650114",
            "codeDescription": "语音接入"
        },
        {
            "acId": 288,
            "mediatypeId": 5,
            "accessCode": "650115",
            "codeDescription": "语音接入"
        }
    ]
}