获取账户通话记录
读取您的 API 账户的呼入或呼出通话记录。这些记录包含私密的通话和计费信息。请仅在经过授权的服务端工作流程中处理这些记录，避免不必要的日志记录或共享。
此旧版端点目前采用固定的默认日期范围，且不支持分页。如果需要其他报表周期或大量导出历史记录，请使用门户的通话历史记录/导出工作流程；此端点的自定义日期参数不可靠。
请求
从账户允许的源 IP 地址，使用已启用的 API 账户通过 HTTPS 进行身份验证。示例使用存放在环境变量中的凭据。受支持的默认时间范围请求不需要请求体。
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
https://api.multitel.net/v3/cdrs| 路径 | 范围 |
|---|---|
| /v3/cdrs | 默认日期范围内的账户呼入记录。 |
| /v3/cdrs/{number} | 号码与所提供号码完全一致的呼入记录。建议使用您号码清单中保存的完整数字号码。 |
| /v3/cdrs/all/outbound | 默认日期范围内的账户呼出记录。呼出分支会忽略第一个路径参数；此处的 all 是占位符，并非呼入记录的通配符。 |
请严格使用上方所示的方向值 inbound 或 outbound。呼出分支未实现按号码筛选。在该路径中添加号码不会缩小呼出结果的范围。
默认报表时间范围
查询从服务器日历中今天之前 30 天的那一天的零时开始，到今天开始时的零时结束。因此，查询不包含今天零时之后的时段。这并不是截至当前时刻的滚动 720 小时时间范围。
当前实现无法可靠地支持 date_from/date_to 表单字段：提供自定义日期会导致其分区年份变量未被赋值。请勿在生产报表中使用这些字段。查询字符串日期和分页参数也未被实现为替代方案。
响应
仅展示部分呼入字段作为示例；这些数据是虚构的，并非完整的返回记录。
{
"status": {
"code": "200",
"msg": "",
"results": 1
},
"response": [
{
"number": "12025550123",
"callerid": "12025550124",
"disposition": "ANSWERED",
"billseconds": "60",
"billcost": "0.0100",
"callsid": "11111111111111111111111111111111",
"date_created": "2026-10-01 12:00:00 UTC"
}
]
}response 是一个列表。通用响应封装中可以包含 status.results，用于表示行数。结果代码可以是字符串。没有记录时，结果会使用 API 代码 404，并附带 No entries found 消息，而不是返回表示成功的空列表。
记录字段
| 字段 | 含义 |
|---|---|
| number, callerid | 呼入记录所选返回字段中的被叫号码和主叫标识符。 |
| calling, called, callerid | 呼出记录所选返回字段中的主叫和被叫标识符。请勿根据主叫号码显示信息推断用户身份已经过验证。 |
| disposition, billseconds, billcost | 已存储的通话结果、计费时长和已存储的计费金额。这些值可能采用旧版数据库的字符串格式。 |
| callsid | 已存储的通话 UUID，用于关联记录。 |
| date_created | 带有字面后缀 UTC 的日期/时间字符串，并不保证是 ISO8601 时间戳。请明确按返回的格式进行解析。 |
| 其他字段 | 呼入记录还包含故障、费用、通道、质量和来源的诊断信息；呼出记录包含通话终接区域的诊断信息。完整响应可能包含基础设施信息，应按私密信息处理。 |
此端点未设置明确的排序或分页。请勿假定结果按最新记录优先排列、行顺序稳定，或存在增量同步游标。返回的计费字段属于已存储的通话记录，并非未来通话的报价。
错误与报表限制
请同时读取 HTTP 状态和 JSON 中的 status.code/status.msg。所选账户和时间范围内没有条目时，会返回 API 代码 404。身份验证和源 IP 限制同样适用。大型未分页报表或不可靠的自定义日期请求可能失败；反复轮询整张表并不是增量导出策略。
经审查的处理程序包含读取查询，不会扣减账户余额或发起通话。返回记录并不能证明有人接听；请根据您的报表用途解读已存储的通话结果和时长。