用途:该技能面向使用 Telnyx Python SDK 的开发者,用于管理 Telnyx 账户相关的余额、支付、发票、Webhook 与审计数据。
主要能力:查询账户余额;查看月度费用明细与汇总(日期范围不得超过 31 天);搜索平台明细记录;列出与按 ID 获取发票;查询和更新支付自动充值偏好;创建存储支付交易;列出用户标签;列出 Webhook 投递记录及按 ID 查询投递调试详情;列出审计日志(尽力而为、最终一致的记录)。
使用方式:先执行 pip install telnyx 安装,再通过 import os 和 from telnyx import Telnyx 初始化客户端,api_key 从环境变量 TELNYX_API_KEY 读取。列表方法返回自动分页迭代器,可用 for item in page_result 逐页遍历。
错误处理:生产代码需处理网络错误(APIConnectionError)、限流(RateLimitError,429,建议指数退避)、状态错误(APIStatusError,如 422 校验错误)。常见状态码包括 401、403、404、422、429。
限制:资料未提供价格、配额或平台支持范围等额外信息;审计日志为最终一致,可能不是实时完整记录。