用途:面向 Telnyx 账户,提供管理余额、付款、发票、Webhook、用户标签以及查看审计日志和明细记录的 REST API curl 示例。
主要能力:查询用户余额详情;查询月度费用摘要与明细(日期范围不能超过 31 天);列出与按 ID 查询发票;读取和更新支付自动充值偏好;创建存储付款交易(必填 amount);列出 Webhook 投递记录并按 ID 查看投递详情与尝试数据;列出用户标签;列出审计事件。
使用方式:curl 在 macOS、Linux 和 Windows 10+ 上预装。先设置 export TELNYX_API_KEY="YOUR_API_KEY_HERE",所有请求使用 Authorization: Bearer $TELNYX_API_KEY 认证。示例:curl -H "Authorization: Bearer $TELNYX_API_KEY" "https://api.telnyx.com/v2/balance"。列表接口分页,用 page[number] 与 page[size] 参数翻页,可通过响应中的 meta.total_pages 判断页数。
错误处理:调用可能因网络、限流(429)、校验(422)或认证(401)失败,需处理。常见代码包括 401 API 密钥无效、403 权限不足、404 资源未找到、422 字段格式错误、429 限流(建议指数退避重试)。
限制:审计日志为尽力而为、最终一致的记录;费用摘要与明细的日期范围不能超过 31 天。各项收费、价格、配额与具体速率暂未提供。