本技能面向 Telnyx 账户的日常运维,提供一组 REST API 的 curl 调用示例,用于查询与管理账户财务、支付、Webhook 及审计数据。所有请求通过 Authorization: Bearer $TELNYX_API_KEY 头部认证,调用前先执行 export TELNYX_API_KEY="YOUR_API_KEY_HERE"。
主要能力:GET /balance 查看余额与可用信用额度;GET /charges_breakdown 和 GET /charges_summary 获取指定日期范围内的月度费用明细与汇总(日期范围不能超过 31 天);GET /invoices 列出分页发票,GET /invoices/{id} 按 ID 获取单张发票;GET /payment/auto_recharge_prefs 读取、PATCH 同一路径更新支付自动充值偏好;POST /payment/stored_payment_transactions 创建存储支付交易(必填 amount);GET /user_tags 列出用户标签;GET /audit_events 检索审计事件;GET /detail_records 跨平台搜索明细记录;GET /webhook_deliveries 及 /webhook_deliveries/{id} 查看 Webhook 投递状态与调试数据。
使用方式:直接以 curl 调用 https://api.telnyx.com/v2 下的对应端点,POST/PATCH 请求加 Content-Type: application/json。列表端点使用 page[number] 和 page[size] 参数分页,可在响应中检查 meta.total_pages。
错误处理:需处理网络错误与 401(密钥无效)、403(权限不足)、404(资源不存在)、422(校验失败)、429(限流,建议指数退避重试)等状态码,示例中用 curl -w 取回 HTTP 状态码并按状态分支处理。
限制:审计日志为尽力而为、最终一致的记录;文档未提供速率限制具体阈值、价格或 SLA 等细节。