SuperAPI AI 工具集

telnyx-account-reports-curl

通用与其它

查看项目

更新于 10-16 06:42

技能介绍

用途:通过 curl 调用 Telnyx REST API,生成并检索用于计费、分析与对账的用量报表,资料以 curl 示例形式给出各接口的调用方式。

主要能力:接口覆盖通话事件列表(GET /call_events,按 occurred_at 排序,未指定 leg_id 或 application_session_id 时仅返回最近 24 小时事件);账本计费组报表的创建与获取(POST/GET /ledger_billing_group_reports);旧版 CDR 与 MDR 明细报表请求的列表、创建、查询与删除(/legacy/reporting/batch_detail_records/voice 与 /messaging,创建时 start_time、end_time 为必填);CDR 可用字段查询;以及各类用量报表(usage_reports 下的 messaging、number_lookup、voice)的列表、创建、按 ID 查询与删除。列表接口分页,可用 page[number]、page[size] 参数,并检查 meta.total_pages。

使用方式:curl 通常已预装;先设置环境变量 export TELNYX_API_KEY="YOUR_API_KEY_HERE",请求头使用 Authorization: Bearer $TELNYX_API_KEY,按需带上 Content-Type: application/json 与 JSON 请求体,接口基址为 https://api.telnyx.com/v2/。

限制与错误处理:生产代码需处理网络错误、401(密钥无效)、403(权限不足)、404(资源不存在)、422(校验错误)、429(限流,建议退避重试)等;可用 curl -s -w 获取 HTTP 状态码并按状态分支处理。报表字段、分页与过滤参数较多,具体可用值以对应接口返回结构为准。