用途:面向 Telnyx 账户的报表技能,使用 Ruby SDK 生成与获取计费、分析和数据对账所需的用量报表。
主要能力:查询通话事件;创建与获取账单组报表;管理 MDR 消息明细报表与 CDR 语音明细报表(列出、创建、查询、删除);获取 CDR 可用字段;管理 MDR 与 CDR 用量报表;查询与提交 telco 数据用量报表;查看与创建 CSV 下载;同步生成并获取 CDR 用量报表。列表接口支持分页,可用 page.auto_paging_each 迭代。
使用方式:安装命令为 gem install telnyx。初始化:client = Telnyx::Client.new(api_key: ENV["TELNYX_API_KEY"])。调用形如 client.call_events.list、client.ledger_billing_group_reports.create、client.legacy.reporting.batch_detail_records.messaging.create(end_time: ..., start_time: ...) 等;部分创建接口需必填 start_time 与 end_time。
错误处理:需处理网络错误、429 限流、422 校验错误、401 认证错误,限流可按指数退避重试;常见状态码含义为 401 密钥无效、403 权限不足、404 资源不存在、422 字段格式校验失败、429 限流。
适用场景:账单核对、用量分析、消息与语音明细导出、对账等。
限制:通话事件未指定 leg_id 或 application_session_id 过滤时仅覆盖最近 24 小时;同步 CDR 用量报表响应可能需要数分钟;报表状态包含 pending、complete、failed、deleted 或 PENDING、COMPLETE、FAILED、EXPIRED,需要轮询或按状态判断结果。其他细节暂未提供。