# 查询指定VDN下的呼叫信息（v2） #### 场景描述 提供根据主叫号码、被叫号码、时间段查询指定vdn的呼叫信息。 对比v1接口，v1接口仅提供呼入通话的呼叫信息，v2接口新增isCallIn参数，可以选择查询呼入或是呼出的呼叫信息，所查询数据留存周期为一天。 #### 接口方法 POST #### 接口URI https://ip:port/rest/cmsapp/v2/openapi/vdn/querycalls 其中，公有云环境请联系管理员获取，ip为CC-CMS服务器地址，port为CC-CMS服务器的HTTPS端口号。 非公有云环境如果配置了NSLB服务，ip请填写NSLB的服务器地址，port为CC-CMS服务在NSLB映射的HTTPS端口号。 #### 请求说明 表1请求Headers参数说明 | 参数名称 | 是否必选 | 参数类型 | 默认值 | 说明 | |:---|:---|:---|:---|:---| | Content-Type | 必选 | String | 无 | 固定填 application/json;charset=UTF-8。 | | Authorization | 必选 | String | 无 | 生成方式参见[C2 监控/系统外呼/话单/知识库类接口鉴权方式](https://support.huaweicloud.com/api-ccfs-cec/cec_07_0003.html#ZH-CN_TOPIC_0000002481273406)。 | 表2请求Body参数说明 | 参数名称 | 是否必选 | 参数类型 | 默认值 | 说明 | |:---|:---|:---|:---|:---| | ccId | 必选 | int | 无 | 呼叫中心编号。 取值范围：1～65535 | | vdn | 必选 | int | 无 | 虚拟中心编号。 取值范围：1～5000 | | callerNo | 选填 | string | 无 | 主叫号码，可以为空值，表示查询所有。 由数字组成，需要符合号码规范 | | calleeNo | 选填 | string | 无 | 被叫号码，可以为空值，表示查询所有。 由数字组成，需要符合号码规范 | | beginDate | 必填 | long | 无 | 查询时间段的开始时间。 值为毫秒级时间戳，时间不能早于前一天的0点0分0秒 | | endDate | 必填 | long | 无 | 查询时间段的结束时间。 值为毫秒级时间戳，时间不能晚于今天的23点59分59秒 | | isCallIn | 必填 | string | 无 | 值为字符串"true"时，表示查询呼入的呼叫信息，值为字符串"false"时，表示查询呼出的呼叫信息 | | limit | 选填 | int | 无 | 查询数目限制。 最大为100。 | | offset | 选填 | int | 无 | offset用于确定查询的起始页。 offset取值公式为：offset=limit\*(page-1)，取值范围：\>=0。 page为需要查询的起始页。 | #### 响应说明 表3响应消息体参数说明 | 参数名称 | 参数类型 | 说明 | |:---|:---|:---| | resultCode | string | 查询结果。取值如下： - "0100000"：成功 - 其他：失败 - 失败的原因说明请参见[错误码参考](https://support.huaweicloud.com/api-ccfs-cec/cec_07_0696.html#ZH-CN_TOPIC_0000002481273824)。 | | resultDesc | object | 查询成功后，返回结果信息的对象。 | | data | array\ | 返回结果信息的对象数组。该对象数组的参数说明请参见[表4] | | count | int | 可查询数据的数量 | 表4data对象参数说明 | 参数名 | 数据类型 | 说明 | |:---|:---|:---| | logDate | long | 数据入库时间，毫秒级时间戳 | | callerNo | string | 主叫号码 | | calleeNo | string | 被叫号码 | | callId | string | 呼叫ID | | callType | int | 呼叫类型，请参见[呼叫类型说明](https://support.huaweicloud.com/api-ccfs-cec/cec_07_0700.html#ZH-CN_TOPIC_0000002481273828) | | waitBegin | long | 等待开始时间，毫秒级时间戳 | | ackBegin | long | 应答开始时间，毫秒级时间戳 | | callBegin | long | 呼叫开始时间，毫秒级时间戳 | | callEnd | long | 呼叫结束时间，毫秒级时间戳 | | vdn | int | 虚拟呼叫中心编号 | | leaveReason | int | 呼叫离开设备原因，请参见[表1](https://support.huaweicloud.com/api-ccfs-cec/cec_07_0703.html#ZH-CN_TOPIC_0000002481113866__zh-cn_topic_0000002509989775_zh-cn_topic_0000001235160253_table680416993017) | | mediaType | int | 媒体类型，具体请参见[表1](https://support.huaweicloud.com/api-ccfs-cec/cec_07_0698.html#ZH-CN_TOPIC_0000002513233715__zh-cn_topic_0000002510109741_zh-cn_topic_0000001843009401_zh-cn_topic_0000001451970565_zh-cn_topic_0240433933_table13565990)。 | | subMediaType | int | 子媒体类型，具体请参见[表3](https://support.huaweicloud.com/api-ccfs-cec/cec_07_0644.html#ZH-CN_TOPIC_0000002481273790__zh-cn_topic_0000002478109764_zh-cn_topic_0284486991_table1124114435517)。 | #### 错误码 请参见[错误码参考](https://support.huaweicloud.com/api-ccfs-cec/cec_07_0696.html#ZH-CN_TOPIC_0000002481273824)。 #### 报文样例 - 请求头 ``` Content-Type: application/json;charset=UTF-8 Authorization: ****************** ``` - 请求参数 ``` { "ccId":1, "vdn":170, "callerNo": "12345", "calleeNo": "23131", "beginDate": "14511111111", "endDate": "14522222222", "isCallIn":"true", "limit": 10, "offset": 0 } ``` - 响应头 ``` HTTP/1.1 200 OK Content-Type: application/json;charset=UTF-8 Date: Mon, 02 Jul 2018 02:43:03 GMT ``` - 响应参数 ``` { "resultCode":"0100000", "resultDesc":{ "data":[ { "logDate": "1615717765000", // 统计时间 "callerNo": "1212", // 主叫号码 "calleeNo": "12121212",// 被叫号码 "callId": "167789709-33", // 呼叫标识 "callType": "1",// 呼叫类型 "waitBegin": "1615717765000",// 呼叫等待开始时间 "ackBegin": "1615717765000",// 呼叫应答时间 "callBegin": "1615717765000",// 通话开始时间 "callEnd": "1615717765000",// 通话结束时间 "vdn": 170, // vdn编号 "leaveReason": "1", // 呼叫离开设备原因 "mediaType":53, // 媒体类型 "subMediaType":1 // 子媒体类型 } ], count: 5 } } ```