## 话单查询
>[info] **功能说明**
> 话单信息查询可以直接查询数据库的话单表，也可以通过API接口根据callid查询，如：用户是否摘机，通话时长，录音文件，挂机原因等信息。
> 提示：在“API外呼”、“语音通知”的接口中，都会返回callid
* **请求地址**
```
{base_url}/{api_version}/cdr
```
* **提交数据**
| 参数 | 类型 | 描述 |
| --- | --- | --- |
| callid | string | 本次通话的唯一uuid。|
* **响应参数**
| 参数 | 类型 | 描述 |
| --- | --- | --- |
| callid | string | 本次通话的唯一uuid。|
| start_stamp | datetime | 通话开始时间。 |
| answer_stamp | datetime | 被叫应答时间。|
| end_stamp | datetime | 通话结束时间。|
| billsec | int | 通话时长。|
| ring_duration | int | 座席分机振铃时长，呼入或API外呼有效（API外呼是系统拨打座席分机，分机振铃，座席摘机，系统才拨打外线号码）。|
| ext_duration | int | 座席分机通话时长。|
| call_prefix | string | 中继的外呼前缀，即自动加拨号码（后台中继管理中配置的外呼前缀参数）。|
| callfrom | string | 主叫号码。|
| callto | string | 被叫号码。|
| type | string | 呼叫方向:inbound,outbound。|
| callroter | string | 表示本次呼叫是哪里发起的呼叫，如：API外呼，使用话机直接拨号，语音通知（api,dial,voc）。|
| hangup_cause | string | 挂机原因。|
| hangup_cause_specific | string | 挂机原因的SIP代码。|
| recording | string | 录音文件名。|
| trunk_name | string | 本次通话使用的中继。|
| hangup_firstin | string | 座席和外线谁先挂机（agent/customer）。|
| rtp_use_codec | string | 本次通话使用的语音编码，如G711,G729等。|
| data | obj | json对象，该值是API外呼或者语音通知提交的data参数值，方便开发者与业务数据匹配或者制作统计报表。|
| callback_domain | string | 回调地址，该值是API外呼或者语音通知提交的callbackDomain参数值。|
| callback_result | string | 回调结果。|
* **响应示例**
```
{
"status": "success",
"data": {
"id": 4,
"callid": "df38656d-7242-4bae-a94b-43dba2d37156",
"start_stamp": "2021-02-19 16:05:08",
"answer_stamp": "2021-02-19 16:05:08",
"bridge_stamp": "2021-02-19 16:05:08",
"end_stamp": "2021-02-19 16:05:17",
"billsec": 9,
"ring_duration": 0,
"ext_duration": 6,
"call_prefix": "",
"callfrom": "8001",
"callto": "13999999999",
"ext": "8001",
"type": "outbound",
"callroter": "api",
"hangup_cause": "NORMAL_CLEARING",
"hangup_cause_specific": "",
"recording": "20210219/202102191602-df38656d-7242-4bae-a94b-43dba2d37156-8001-13999999999.mp3",
"trunk_name": "GSM",
"trunk_number": "",
"hangup_firstin": "agent",
"rtp_use_codec": "G729",
"data": "{"name ": "Alice","age": "20"}",
"callback_domain": "http://www.baidu.com",
"callback_result": "{"status ":"success "}"
},
"msg": ""
}
```
