SuperAPI AI 工具集

telnyx-account-reports-curl

数据与分析

查看项目

更新于 10-16 03:38

技能介绍

用途:该技能面向 Telnyx 账户报表场景,通过 curl 命令调用 Telnyx REST API,生成并获取用于计费、分析和数据对账的用量报告,同时也包含查询通话事件的能力。

主要能力:可列出通话事件(GET /call_events,按 occurred_at 排序,未指定 leg_id 或 application_session_id 时仅过滤近 24 小时事件);创建与查询账本计费组报表(POST/GET /ledger_billing_group_reports,可指定 year、month);管理 MDR 消息明细报表请求的列表、创建、查询与删除(/legacy/reporting/batch_detail_records/messaging,创建时 start_time 与 end_time 为必填);管理 CDR 语音明细报表(/legacy/reporting/batch_detail_records/voice),并可获取可用 CDR 字段;管理消息与语音用量报表(/legacy/reporting/usage_reports/messaging、/voice)以及号码查询类电信数据用量报表(/legacy/reporting/usage_reports/number_lookup)。

使用方式:curl 已在 macOS、Linux 及 Windows 10+ 预装;先设置 export TELNYX_API_KEY="YOUR_API_KEY_HERE",请求头使用 Authorization: Bearer $TELNYX_API_KEY。列表端点分页可通过 page[number] 与 page[size] 查询参数控制,并检查响应中的 meta.total_pages。

错误处理:调用可能返回网络错误、限流(429)、校验错误(422)或认证错误(401)。常见码包括 401 无效 API 密钥、403 权限不足、404 资源不存在、422 字段格式错误、429 需按指数退避重试。

限制:资料未提供各接口的速率上限、价格、配额与报表生成时限等细节。返回字段与枚举(如状态 pending/complete/failed/deleted 或 PENDING/COMPLETE/FAILED/EXPIRED)以原文为准。