SuperAPI AI 工具集

telnyx-account-ruby

通用与其它

查看项目

更新于 10-16 04:30

技能介绍

用途:通过 Telnyx Ruby SDK 管理账户相关资源,包括余额、月度费用、发票、支付与自动充值、Webhook 投递记录、审计日志和平台明细记录。

安装与初始化:运行 gem install telnyx,然后创建 client = Telnyx::Client.new(api_key: ENV["TELNYX_API_KEY"])。

主要能力:查询余额(client.balance.retrieve);检索月度费用明细与汇总(client.charges_breakdown.retrieve、client.charges_summary.retrieve,日期范围不能超过 31 天);搜索平台明细记录(client.detail_records.list);列出与获取发票(client.invoices.list/retrieve);查看和更新自动充值偏好(client.payment.auto_recharge_prefs.list/update);创建存储支付交易(client.payment.create_stored_payment_transaction(amount: "120.00"),amount 必填);列出和查询 Webhook 投递(client.webhook_deliveries.list/retrieve);列出审计日志(client.audit_events.list);列出用户标签(client.user_tags.list)。

分页:使用 page.auto_paging_each { |item| puts item.id } 自动迭代。

错误处理:需处理网络错误、限流(429)、验证错误(422)、认证错误(401)等,示例中使用 begin/rescue 捕获 Telnyx::Errors::APIConnectionError、RateLimitError、APIStatusError,限流时按指数退避重试。

限制:审计日志为最终一致性记录;费用日期范围上限 31 天;各接口返回字段较多,文档仅列出部分结构。具体收费与价格信息暂未提供。