CDR 报表 (v2) 文档
CDR 报表 (v2)
v2
CDR 报表 (v2)
v2
CDR 报表 (v2)
指定时间窗口内的通话详单
API v2v21 个端点
概述
计费说明:本 API 按返回的记录数量计费。具体价格请联系您的客户经理。返回该服务在指定时间窗口内的通话详单。发送 JSON 请求体(Content-Type: application/json)。与所有报表接口一样,start_time 和 end_time 为必填项;缺少时请求返回 400。svc_id 为可选项,默认为令牌所属的服务;如果传入该参数,令牌对应的用户必须已获该服务的授权,否则请求返回 403。mode 字段用于选择 normal(默认,标准 CDR 列表及汇总)或 extended(相同的记录,外加 IVR 和队列时间以及等待时间)。两种模式下的请求体完全相同。limit 上限为 5000;请求更大的值时会被降为 5000,因此请使用 offset 对更大的结果集进行分页。未知参数将被忽略。
可用端点
POST
/api/v2/reports/cdr关键参数
mode(String)normal(默认)或 extended。
svc_id(Integer)要生成报表的服务。默认为令牌所属的服务。
start_time(Integer (epoch ms))时间窗口起点。
end_time(Integer (epoch ms))时间窗口终点(以通话开始时间为准,不含该时刻)。
offset(Integer)分页偏移量(两种模式相同)。默认为 0。
limit(Integer)每页条数。默认为 30。最大为 5000;超出的值将被截断。
使用场景
Normal 模式
默认模式。ring_start_time、start_time 和 end_time 以 IST 时区的 yyyy-MM-ddTHH:mm:ss 字符串形式返回。
0 个参数见“示例”
Extended 模式
将 mode 设为 extended。外层结构及所有 normal 模式字段保持不变;每条记录还会包含 agent_answered、ivr_in_time、ivr_out_time、ivr_duration、queue_in_time、queue_out_time、queue_duration 和 total_wait_duration。
0 个参数见“示例”
快速示例
使用简单的 cURL 命令试用此 API
基础 API 调用
curl -X POST 'https://telephonycloud.co.in/api/v2/reports/cdr' \
-H 'Authorization: Bearer <YOUR_TOKEN>' \
-H 'Content-Type: application/json' \
-d '{"svc_id": 3, "start_time": 1775759400000, "end_time": 1776364200000, "offset": 0, "limit": 30, "call_type": "OUTBOUND", "disposition": "ANSWER"}'💡 将 <YOUR_TOKEN> 替换为您的 API 令牌
响应预览
此 API 的示例响应
示例响应
{"count":268,"data":[{"call_transaction_id":"d341e47a-767a-44fb-8d79-9bf38f4caa28","svc_id":3,"call_type":"OUTBOUND","customer_number":"9634780846","agent_number":"10101","disposition":"Answer","durat...在“响应”部分查看完整的响应格式
