获取通话记录接口
<h4>接口说明：客户主动拉取通话记录列表的接口。</h4>
<h4>请求方式：POST，form-data格式</h4>
<h4>获取通话记录接口请求参数</h4>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">类型</th>
<th style="text-align: left;">是否必须</th>
<th style="text-align: left;">说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">service</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">App.Sip_Cdr.GetBill</td>
</tr>
<tr>
<td style="text-align: left;">token</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">通过授权接口获取的token</td>
</tr>
<tr>
<td style="text-align: left;">starttime</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">(拔打)起始时间，格式：yyyy-mm-dd hh\:mm\:ss</td>
</tr>
<tr>
<td style="text-align: left;">endtime</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">(拔打)结束时间，格式：yyyy-mm-dd hh\:mm\:ss</td>
</tr>
<tr>
<td style="text-align: left;">syncflag</td>
<td style="text-align: left;">int</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">获取记录类型:1、获取未查询过的记录(默认)；2、获取已查询过的记录；3、获取全部记录。</td>
</tr>
<tr>
<td style="text-align: left;">direction</td>
<td style="text-align: left;">int</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">呼叫方向：1、呼入； 2、呼出；3、全部（默认）。</td>
</tr>
<tr>
<td style="text-align: left;">callmethod</td>
<td style="text-align: left;">int</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">呼叫方法：0、不限；1、分机互拨；2、分机直拨（手拨）；3、API呼叫（默认）；4、API双呼；5、预测式外呼；6、IVR/群呼。</td>
</tr>
<tr>
<td style="text-align: left;">currentpage</td>
<td style="text-align: left;">int</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">页数，默认：1</td>
</tr>
<tr>
<td style="text-align: left;">itemsperpage</td>
<td style="text-align: left;">int</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">每页数量，默认：10，最小：1；最大：1000</td>
</tr>
<tr>
<td style="text-align: left;">extnumber</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">分机号，多个分机号用英文逗号隔开，传空值时为全部</td>
</tr>
<tr>
<td style="text-align: left;">destnumber</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">呼叫的目标号码，传空值时为全部</td>
</tr>
<tr>
<td style="text-align: left;">userid</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">自定义数据(员工ID)，可为空值</td>
</tr>
<tr>
<td style="text-align: left;">memberid</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">自定义数据(会员ID)，可为空值</td>
</tr>
<tr>
<td style="text-align: left;">chengshudu</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">自定义数据(成熟度)</td>
</tr>
<tr>
<td style="text-align: left;">customuuid</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">自定义数据(客户ID)</td>
</tr>
</tbody>
</table>
<h4>获取通话记录接口请求示例（PHP）</h4>
<pre><code>&lt;?php
$apiUrl = 'http://127.0.0.1:8080';
$postFields = [
'service' =&gt; 'App.Sip_Cdr.GetBill',
'token' =&gt; 'ABCDEFG',
'starttime' =&gt; '2019-01-12 00:00:00',
'endtime' =&gt; '2020-12-12 00:00:00',
'direction' =&gt; 3
'syncflag' =&gt; 3,
'callmethod' =&gt; 0,
'currentpage' =&gt; 1,
'itemsperpage' =&gt; 10,
];
$curl = curl_init();
curl_setopt($curl, CURLOPT_URL, $apiUrl);
curl_setopt($curl, CURLOPT_POST, 1);
curl_setopt($curl, CURLOPT_POSTFIELDS, $postFields);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
$response = curl_exec($curl);
$curlError = curl_error($curl);
curl_close($curl);
var_dump($response);
?&gt;
</code></pre>
<h4>返回数据结构示例</h4>
<pre><code>{
&quot;ret&quot;: 200,
&quot;data&quot;: {
&quot;status&quot;: 0,
&quot;desc&quot;: &quot;获取成功&quot;,
&quot;result&quot;: {
&quot;totalitems&quot;: 8151,
&quot;currentpage&quot;: 1,
&quot;itemsperpage&quot;: 10,
&quot;bills&quot;: [
{
&quot;id&quot;: 22670,
&quot;extnumber&quot;: &quot;&quot;,
&quot;destnumber&quot;: &quot;13387525701&quot;,
&quot;displaynumber&quot;: &quot;2190170001&quot;,
&quot;starttime&quot;: &quot;2019-09-27 14:58:37&quot;,
&quot;answertime&quot;: null,
&quot;endtime&quot;: &quot;2019-09-27 14:59:05&quot;,
&quot;duration&quot;: 28,
&quot;billsec&quot;: 0,
&quot;direction&quot;: &quot;callout&quot;,
&quot;callmethod&quot;: 6,
&quot;userid&quot;: &quot;0&quot;,
&quot;memberid&quot;: &quot;0&quot;,
&quot;chengshudu&quot;: &quot;0&quot;,
&quot;customuuid&quot;: &quot;0&quot;,
&quot;recordfilename&quot;: &quot;&quot;,
&quot;downloadip&quot;: &quot;&quot;,
&quot;hangupdirection&quot;: 10041,
&quot;hangupcause&quot;: 10020,
&quot;userkey&quot;:&quot;#&quot;
}
]
},
&quot;reqtime&quot;: 1581502410,
&quot;rsptime&quot;: 1581502410
},
&quot;msg&quot;: &quot;&quot;
}
</code></pre>
<h4>返回参数说明</h4>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">类型</th>
<th style="text-align: left;">说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">result</td>
<td style="text-align: left;">objest</td>
<td style="text-align: left;">返回的结果集</td>
</tr>
<tr>
<td style="text-align: left;">—totalitems</td>
<td style="text-align: left;">int</td>
<td style="text-align: left;">记录总数</td>
</tr>
<tr>
<td style="text-align: left;">—currentpage</td>
<td style="text-align: left;">int</td>
<td style="text-align: left;">当前页码</td>
</tr>
<tr>
<td style="text-align: left;">—itemsperpage</td>
<td style="text-align: left;">int</td>
<td style="text-align: left;">每页数量</td>
</tr>
<tr>
<td style="text-align: left;">—bills</td>
<td style="text-align: left;">array</td>
<td style="text-align: left;">记录数组</td>
</tr>
<tr>
<td style="text-align: left;">——id</td>
<td style="text-align: left;">int</td>
<td style="text-align: left;">记录id</td>
</tr>
<tr>
<td style="text-align: left;">——extnumber</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">分机号</td>
</tr>
<tr>
<td style="text-align: left;">——destnumber</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">目标号码</td>
</tr>
<tr>
<td style="text-align: left;">——displaynumber</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">显示号码</td>
</tr>
<tr>
<td style="text-align: left;">——starttime</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">呼叫时间</td>
</tr>
<tr>
<td style="text-align: left;">——answertime</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">应答时间</td>
</tr>
<tr>
<td style="text-align: left;">——endtime</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">通话结束时间</td>
</tr>
<tr>
<td style="text-align: left;">——duration</td>
<td style="text-align: left;">int</td>
<td style="text-align: left;">呼叫等待时长</td>
</tr>
<tr>
<td style="text-align: left;">——billsec</td>
<td style="text-align: left;">int</td>
<td style="text-align: left;">通话时长</td>
</tr>
<tr>
<td style="text-align: left;">——direction</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">呼叫方向</td>
</tr>
<tr>
<td style="text-align: left;">——callmethod</td>
<td style="text-align: left;">int</td>
<td style="text-align: left;">呼叫方式</td>
</tr>
<tr>
<td style="text-align: left;">——userid</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">自定义参数(用户id)</td>
</tr>
<tr>
<td style="text-align: left;">——memberid</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">自定义参数(会员id)</td>
</tr>
<tr>
<td style="text-align: left;">——chengshudu</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">自定义参数(成熟度)</td>
</tr>
<tr>
<td style="text-align: left;">——customuuid</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">自定义参数(客户id)</td>
</tr>
<tr>
<td style="text-align: left;">——recordfilename</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">通话记录文件名</td>
</tr>
<tr>
<td style="text-align: left;">——downloadip</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">下载ip</td>
</tr>
<tr>
<td style="text-align: left;">——hangupdirection</td>
<td style="text-align: left;">int</td>
<td style="text-align: left;">挂断方向</td>
</tr>
<tr>
<td style="text-align: left;">——hangupcause</td>
<td style="text-align: left;">int</td>
<td style="text-align: left;">挂断原因</td>
</tr>
<tr>
<td style="text-align: left;">——userkey</td>
<td style="text-align: left;">string</td>
<td style="text-align: left;">用户按键</td>
</tr>
</tbody>
</table>
<h4>Postman请求参数示例</h4>
<p><img src="https://www.showdoc.cc/server/api/common/visitfile/sign/06f3da7ba01cab3c0b2fa9c4181a0671?showdoc=.jpg" alt="" /></p>