telnyx-account-reports-java

用途：该技能面向 Java 开发者，展示如何通过 Telnyx Java SDK 生成和检索账户用量报表，用于计费、分析与对账。

安装与初始化：Maven 使用 groupId com.telnyx.sdk、artifactId telnyx、version 6.36.0；Gradle 使用 implementation("com.telnyx.sdk:telnyx:6.36.0")。通过 TelnyxOkHttpClient.fromEnv() 初始化 TelnyxClient。

主要能力与接口：

1. 呼叫事件：client.callEvents().list()，可按 filter 参数过滤，默认仅返回最近 24 小时事件。
2. 账本计费组报表：client.ledgerBillingGroupReports().create() 创建、retrieve(id) 获取。
3. MDR 详细报表（消息）：legacy().reporting().batchDetailRecords().messaging() 支持 list、create、retrieve、delete，创建必需 start_time 与 end_time，可选 connections、directions、include_message_body 等。
4. CDR 报表（语音）：legacy().reporting().batchDetailRecords().voice() 支持 list、create、retrieveFields、retrieve、delete，创建必需 start_time 与 end_time，可选 call_types、connections、fields 等。
5. MDR 用量报表：legacy().reporting().usageReports().messaging() 支持 list、create、retrieve、delete。
6. 号码查询用量报表：usageReports().numberLookup() 支持 list 与 create。

用法要点：列表方法返回分页对象，可用 .autoPager() 自动遍历，或用 .hasNextPage() 与 .nextPage() 手动分页。API 调用可能抛出网络错误、限流（429）、校验（422）或认证（401）异常，生产代码应捕获 TelnyxServiceException 并按状态码处理。

限制：资料未提供收费、价格、平台或效果信息；部分字段详情与接口返回内容在资料中被截断，暂未提供完整说明。