
# 获取点对点的呼叫记录
#### 接口名称
WEB_GetP2PCallRecordsAPI
#### 功能描述
获取点对点呼叫记录时调用该接口。
#### 应用场景
获取点对点的呼叫记录，包括呼出、已接听、未接听三类，每类最多16条，最多纪录48条。
#### URL
https://ip/action.cgi?ActionID=WEB_GetP2PCallRecordsAPI
#### 参数
表1获取点对点的呼叫记录参数 
| 参数       | 类型  | 取值范围     | 参数说明                                                                                                                                                                                                                                                                                                                                                                                                       |
|:---|:---|:---|:---|
| ParamInt | int | \[1, 3\] | 参数类型。如果请求参数为空，表示要获取全部通话记录。 1：呼出记录 2：已接受记录 3：未接听记录 |
   
#### 返回值
表2获取点对点的呼叫记录返回值 
| 参数      | 类型     | 取值范围     | 参数说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
|:---|:---|:---|:---|
| success | int    | \[0, 1\] | 响应结果 0：失败 1：成功                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| data    | Object | 可选       | 成功返回数据。详细参考[表3]。 例如： {"success":1,"data":"{\\"CallList\\":\[{\\"uwID\\":2,\\"ucRecType\\":1,\\"aucRcdName\\":\\"192.168.64.228\\",\\"aucCallCode\\":\\"\\",\\"ucCallType\\":8,\\"uwCallRate\\":159,\\"StartTime\\":\\"2016\\\\\\/03\\\\\\/02 15:23:42\\",\\"StartTimeOffset\\":28800,\\"StartTimeDayLight\\":0,\\"StopTime\\":\\"2016\\\\\\/03\\\\\\/02 15:23:42\\",\\"StopTimeOffset\\":28800,\\"StopTimeDayLight\\":0,\\"StartTimeByYMD\\":\\"2016\\\\\\/03\\\\\\/02 15:23:42\\",\\"StopTimeByYMD\\":\\"2016\\\\\\/03\\\\\\/02 15:23:42\\",\\"aucIPAddr\\":\\"192.168.64.228\\",\\"ucE1Port\\":0,\\"ucIsGateway\\":0,\\"ucH320EnRate\\":144,\\"aszStateCode\\":\\"\\",\\"aszAreaCode\\":\\"\\",\\"aszPhoneCode\\":\[\],\\"useAux\\":1,\\"mediaType\\":1 }\]}"} |
| error   | Object | 可选       | 失败返回错误信息。详细参考 [表5]。 例如：{"success":0,"error":"id":100666995,"code":33558532,"params":\[\]}}                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
   
 表3data 
| 参数       | 类型    | 取值范围        | 参数说明                                                                                                                                |
|:---|:---|:---|:---|
| CallList | Array | CallList 对象 | 成员变量参考[表4]。 |
   
 表4CallList 
| 参数                | 类型          | 取值范围            | 参数说明                                                                                                                                                                                                                                                                                                                                                                                    |
|:---|:---|:---|:---|
| uwID              | int         | \[0, 65535\]    | 记录ID                                                                                                                                                                                                                                                                                                                                                                                    |
| ucRecType         | int         | \[1, 3\]        | 记录类型 1：呼出记录 2：已接听记录 3：未接听记录 |
| aucRcdName        | String      | 非空              | 记录名称                                                                                                                                                                                                                                                                                                                                                                                    |
| aucCallCode       | String      | 非空              | 呼叫号码                                                                                                                                                                                                                                                                                                                                                                                    |
| ucCallType        | int         | 32 位整数          | 记录的通话类型                                                                                                                                                                                                                                                                                                                                                                                 |
| uwCallRate        | int         | 32 位整数          | 通话带宽                                                                                                                                                                                                                                                                                                                                                                                    |
| StartTime         | Object      | stStartTime 对象  | 开始时间                                                                                                                                                                                                                                                                                                                                                                                    |
| StartTimeOffset   | int         | \[0, 128\]      | 时区偏移                                                                                                                                                                                                                                                                                                                                                                                    |
| StopTime          | String      | 最长32字节          | 结束时间                                                                                                                                                                                                                                                                                                                                                                                    |
| aucIPAddr         | String      | 最长40字节          | 远端IP地址                                                                                                                                                                                                                                                                                                                                                                                  |
| ucE1Port          | int         | 32位整数           | E1端口号                                                                                                                                                                                                                                                                                                                                                                                   |
| ucIsGateway       | int         | \[0, 1\]        | 是否启用语音网关 0：否 1：是                                                                                                                                 |
| ucH320EnRate      | int         | 32位整数           | H.320呼叫速率枚举                                                                                                                                                                                                                                                                                                                                                                             |
| aszStateCode      | String      | 最长32个字节         | ISDN呼叫时的国家号                                                                                                                                                                                                                                                                                                                                                                             |
| aszAreaCode       | String      | 最长32个字节         | ISDN呼叫时的区号                                                                                                                                                                                                                                                                                                                                                                              |
| aszPhoneCode      | String List | aszPhoneCode 对象 | ISDN呼叫时的线路号码                                                                                                                                                                                                                                                                                                                                                                            |
| useAux            | int         | 32位整数           | 通话中是否启用了演示 0：否 1：是                                                                                                                              |
| mediaType         | int         | \[1, 2\]        | SIP通话挂断时的视音频状态 1：视频 2：音频                                                                                                                        |
| callPort          | int16       | 16位整数           | SIP来电呼叫端口                                                                                                                                                                                                                                                                                                                                                                               |
| StartTimeOffset   | int         | 32位整数           | 呼叫时间时区偏移值，单位秒。                                                                                                                                                                                                                                                                                                                                                                          |
| StopTimeOffset    | int         | 32位整数           | 结束时间时区偏移值，单位秒。                                                                                                                                                                                                                                                                                                                                                                          |
| StartTimeDayLight | int         | 32位整数           | 呼叫时间是否启用夏令时 0：否 1：是                                                                                                                            |
| StopTimeDayLight  | int         | 32位整数           | 结束呼叫时间是否启用夏令时 0：否 1：是                                                                                                                           |
   
 表5error 
| 参数    | 类型     | 取值范围     | 参数说明                                                                                                                    |
|:---|:---|:---|:---|
| id    | int    | 32位整数    | 错误id，用于转换。                                                                                                              |
| code  | int    | 32位整数    | 错误码，跟错误id对应，具体含义参考[错误码](https://support.huaweicloud.com/ideahub-api/ideahub_05_0255.html#ZH-CN_TOPIC_0000001309671920)。 |
| param | Object | param 对象 | 失败响应的附带参数。                                                                                                              |
   
