SuperAPI AI 工具集

telnyx-account-ruby

办公与效率

查看项目

更新于 10-16 05:41

技能介绍

用途:通过 Telnyx Ruby SDK 管理 Telnyx 账户相关数据,包括余额、费用、发票、支付与 Webhook 投递记录、审计日志和明细记录查询。

主要能力:读取用户余额详情(可用额度、信用额度、币种、待处理金额);按日期范围(不超过 31 天)获取月度费用明细与汇总;分页列出及按 ID 查询发票;列出并更新支付自动充值偏好(含启用状态、充值金额、阈值、支付方式 credit_paypal/ach);创建存储支付交易;列出与查询 Webhook 投递记录(投递状态、尝试次数、时间戳);列出审计日志;搜索平台明细记录;列出用户标签。

使用方式:安装 gem install telnyx;初始化 client = Telnyx::Client.new(api_key: ENV["TELNYX_API_KEY"]);调用对应资源方法,如 client.balance.retrieve、client.invoices.list、client.charges_summary.retrieve(end_date:..., start_date:...)、client.webhook_deliveries.retrieve(id)、client.payment.auto_recharge_prefs.update。分页可使用 page.auto_paging_each 自动迭代。

错误处理:调用可能返回网络错误、429 限流、422 校验错误、401 鉴权错误等,建议在生产代码中捕获 Telnyx::Errors::APIConnectionError、RateLimitError、APIStatusError,并对 429 使用指数退避重试。

适用场景:需要在 Ruby 应用中集成 Telnyx 账户查询、账单核对、发票管理、支付自动充值配置或 Webhook 投递监控时使用。

限制:审计日志为最终一致性记录,不保证实时准确;费用明细与汇总日期范围不能超过 31 天;具体速率限制、配额及计费细节依赖 Telnyx 账户政策,本资料未提供。