用途:该技能面向 Telnyx 账户报表,提供 Go SDK 示例,用于生成与获取用量报表,服务账单、分析与对账。
安装与初始化:go get github.com/team-telnyx/telnyx-go。初始化时使用 option.WithAPIKey(os.Getenv("TELNYX_API_KEY"))。
主要能力:可列出通话事件(GET /call_events,默认仅近 24 小时,除非指定 leg_id 或 application_session_id);创建与获取账本账单组报表(POST 与 GET /ledger_billing_group_reports,可选 month、year);MDR 详细报表的创建、查询、删除;CDR 报表请求的创建、查询、删除及可用字段查询;MDR 与 CDR 用量报表、号码查询用量报表的创建、查询与删除。
用法要点:所有 API 调用可能返回网络错误、限流(429)、校验(422)或认证(401)错误,生产代码应处理错误并按状态码区分;分页可用 ListAutoPaging() 自动迭代。
限制:通话事件未指定 leg_id 或 application_session_id 时仅返回最近 24 小时数据;部分接口为 legacy/reporting 路径下的旧版接口;资料未提供定价、配额与具体部署平台信息。