# 查询外呼号码
#### 前置条件
已经申请了开发者账号。
#### 场景描述
调用该接口查询指定任务下外呼数据中的号码及其属性。
#### 接口方法
该接口仅支持GET方法。
#### 接口URL
/rest/isales/v1/openapi/campaigns/{vdnId}/calldata/{campaignId}/{dataId}
其中，ip为CC-iSales服务器地址，port为CC-iSales服务器的HTTPS端口号。
表1URL中携带的参数说明 
| 序号 | 参数名        | 参数类型 | 是否必选 | 说明                                                                                                                                      |
|:---|:---|:---|:---|:---|
| 1  | vdnId      | int  | True | 虚拟呼叫中心ID。 取值的类型为整数，取值范围为1～9999。 |
| 2  | campaignId | int  | True | 外呼活动的ID。                                                                                                                                |
| 3  | dataId     | int  | True | 外呼数据的ID。                                                                                                                                |
   
#### 请求说明
表2请求消息头参数 
| 序号 | 名称            | 参数类型   | 是否必选  | 说明                                                                                                                            |
|:---|:---|:---|:---|:---|
| 1  | Content-Type  | String | True  | 固定填 application/json;charset=UTF-8。                                                                                           |
| 2  | Authorization | String | True  | 生成方式参见[C2 监控/系统外呼/话单/知识库类接口鉴权方式](https://support.huaweicloud.com/api-ccfs-cec/cec_07_0003.html#ZH-CN_TOPIC_0000002481273406)。 |
| 3  | locale        | String | False | i18n（internationalization，国际语言代码），如zh_CN表示中文、en_US表示英文等，默认zh_CN。                                                              |
   
无请求消息体。
#### 响应说明
表3消息体参数说明 
| 序号 | 参数名        | 参数类型   | 说明                                                                                                                                                                                                                                                     |
|:---|:---|:---|:---|
| 1  | resultCode | String | 原因码。0200000表示成功，其他表示失败。 具体见[表7]。 |
| 2  | resultDesc | String | 描述。                                                                                                                                                                                                                                                    |
| 3  | returnCode | String | 原因码。0200000表示成功，其他表示失败。 具体见[表7]。 |
| 4  | returnDesc | String | 描述。                                                                                                                                                                                                                                                    |
| 5  | data       | Object | 该条data下的号码以及属性。 具体见[表4]             |
   
 表4data数据说明 
| 序号  | 参数名        | 参数类型   | 说明                                                                                                                                                                                                                                  |
|:---|:---|:---|:---|
| 5.1 | dataId     | String | 外呼数据ID。                                                                                                                                                                                                                             |
| 5.2 | properties | List   | 业务属性。 具体见[表5] |
| 5.3 | calledNos  | List   | 外呼号码 具体见[表6]    |
   
 表5properties数据说明 
| 序号    | 参数名       | 参数类型       | 说明    |
|:---|:---|:---|:---|
| 5.2.1 | propCode  | String     | 属性编码。 |
| 5.2.2 | propName  | String     | 属性名称。 |
| 5.2.3 | propValue | 取决于具体的属性类型 | 属性值   |
   
 表6calledNos数据说明 
| 序号    | 参数名      | 参数类型   | 说明    |
|:---|:---|:---|:---|
| 5.3.1 | calledNo | String | 外呼号码。 |
| 5.3.2 | type     | String | 号码分类。 |
   
#### 触发事件
无
#### 错误结果码
 表7错误原因码说明 
| 序号 | 错误码      | 说明                       |
|:---|:---|:---|
| 1  | 0200001  | 参数异常，异常详情在resultDesc中描述。 |
| 2  | 0200007  | 外呼活动不存在。                 |
| 3  | 02000001 | 参数值为空                    |
| 4  | 02000002 | 参数包含非法字符                 |
| 5  | 02000003 | 参数长度不能大于规定长度             |
| 6  | 02000004 | 参数长度不能小于规定长度             |
| 7  | 02000005 | 参数长度需要介于规定长度之间           |
| 8  | 02000006 | 参数值类型不正确                 |
| 9  | 02000007 | 参数值大小不正确                 |
| 10 | 02000008 | 参数转换异常，请检查请求参数           |
| 11 | 02000009 | 参数组合不正确，请检查请求参数          |
| 12 | 02000010 | hour和minute必须同时存在        |
| 13 | 02000011 | 参数个数不能大于规定个数             |
   
#### 报文样例
- 该接口的请求消息体举例如下： 无
  
- 该接口的响应消息体举例如下：
  ```
  {
      "returnCode": "0200000",
      "data": {
          "dataId": "11330737561851183104",
          "calledNos": [
              {
                  "calledNo": "88881951",
                  "type": null
              }
          ],
          "properties": [
              {
                  "propValue": "12312",
                  "propName": "属性1",
                  "propCode": "1"
              },
              {
                  "propValue": "123",
                  "propName": "属性2",
                  "propCode": "12"
              },
              {
                  "propValue": null,
                  "propName": "属性3",
                  "propCode": "123"
              }
          ]
      },
      "resultCode": "0200000",
      "resultDesc": "query data success",
      "returnDesc": "query data success"
  }
  ```