用途
Telnyx Account - Go 是一个面向 Go 开发者的技能，用于通过 Telnyx 官方 Go SDK 管理账户层面的数据与操作。它覆盖账户余额、费用、发票、支付、Webhook 投递记录、审计日志和明细记录等账户相关功能，帮助开发者在 Go 应用中集成 Telnyx 账户管理能力。
主要能力
该技能提供以下 API 调用示例：
- 审计日志：列出审计日志条目，返回变更类型、变更人、资源 ID、组织 ID、用户 ID 等字段。审计日志为尽力而为、最终一致的记录。
- 账户余额：获取用户余额详情，返回可用信用、余额、信用额度、货币、待处理金额等。
- 月度费用明细：获取指定日期范围内电话号码的月度费用明细，日期范围不能超过 31 天。
- 月度费用汇总：获取指定日期范围内的月度费用汇总，日期范围不能超过 31 天。
- 明细记录搜索：在 Telnyx 平台搜索任意明细记录，返回运营商、费用、状态、消息类型、方向等字段。
- 发票：分页列出发票，以及按 ID 获取单张发票详情。
- 自动充值偏好：列出和更新支付自动充值偏好，可设置启用状态、发票启用、偏好方式（credit_paypal、ach）、充值金额和阈值金额。
- 用户标签：列出所有用户标签，返回号码标签和出站配置文件标签。
- 存储支付交易：创建存储支付交易，金额为必填项。
- Webhook 投递：列出 Webhook 投递记录，以及按 ID 查询投递详情（包含时间戳、投递状态和尝试记录）。
使用方式
安装：
go get github.com/team-telnyx/telnyx-go
初始化客户端：
import ( "context" "fmt" "os"
"github.com/team-telnyx/telnyx-go" "github.com/team-telnyx/telnyx-go/option" )
client := telnyx.NewClient( option.WithAPIKey(os.Getenv("TELNYX_API_KEY")), )
所有示例均假设 client 已按上述方式初始化。
错误处理：所有 API 调用都可能因网络错误、限流（429）、校验错误（422）或认证错误（401）而失败。生产代码中应始终处理错误。常见错误码包括：401 无效 API Key、403 权限不足、404 资源未找到、422 校验错误（检查字段格式）、429 限流（使用指数退避重试）。
分页：使用 ListAutoPaging() 进行自动迭代：iter := client.Resource.ListAutoPaging(ctx, params); for iter.Next() { item := iter.Current() }。
适用场景
该技能适用于需要在 Go 应用中集成 Telnyx 账户财务与审计数据的场景，例如：查询账户余额与信用额度、生成月度费用报表、管理发票、配置自动充值、排查 Webhook 投递问题、审计账户变更记录，以及搜索平台明细记录。
限制
月度费用明细与汇总的日期范围不能超过 31 天。审计日志为尽力而为、最终一致的记录，可能不包含所有变更。该技能仅提供 Go SDK 示例，其他语言或非编程方式暂未提供。具体收费、价格、平台支持范围等信息暂未提供。