通话详单与录音 API

通话详单 (CDR) 模块允许你查询历史通话记录及其详细指标（如通话时长、接通状态、挂断原因等），并提供录音文件的下载。

1. 查询 SIP 通话清单

获取通过软电话或分机拨打 / 接听的通话详情。

GET /api/cdr/list

常用请求参数

参数名	类型	必填	默认值	描述
created_time_start	string	是	-	开始时间 (YYYY-MM-DD HH:mm:ss)
created_time_end	string	是	-	结束时间 (YYYY-MM-DD HH:mm:ss)
rows	integer	否	10	分页大小
record_filename	string	否	-	可选 true (仅看有录音) 或 false (仅看无录音)

响应主要字段说明

• billsec : 计费时长（秒）。
• duration : 总通话时长。
• hangup_cause : 挂断原因。
• record_filename : 录音存储路径及文件名。

---

2. 查询双呼详单

获取通过手机双呼（点击拨号）产生的通话记录。

GET /api/cdr/dual

请求参数

参数名	类型	必填	描述
created_at_start	string	是	开始时间
created_at_end	string	是	结束时间

---

3. 获取详单详情

获取单条详单的完整原始数据。

GET /api/cdr/info

请求参数

• id : 详单 ID。
• type : 详单类型，可选 sip 或 dual 。

---

4. 录音下载

系统提供直接下载接口，需具备相应权限。

GET /api/cdr/download (SIP 录音)

GET /api/cdr/download-dual (双呼录音)

请求参数

• id : 对应的详单 ID。

提示：录音下载接口直接返回二进制流 (Binary Stream)。如果你在 Web 端集成，可以直接将此 URL 作为 <audio> 标签的 src 。

---

通话状态码 (hangup_cause) 参考

状态码	描述
NORMAL_CLEARING	正常挂断
ORIGINATOR_CANCEL	主叫取消呼叫
USER_BUSY	用户忙 (拒接)
NO_ANSWER	无人接听
CALL_REJECTED	呼叫被拒绝