SuperAPI AI 工具集

telnyx-account-reports-python

数据与分析

查看项目

更新于 10-16 03:37

技能介绍

用途:该技能提供 Telnyx 账户报表功能的 Python SDK 示例,帮助开发者生成并获取用于计费、分析与对账的用量报表。

主要能力:

  1. 通话事件查询:GET /call_events,按过滤参数列出通话事件,事件按 occurred_at 排序;未指定 leg_id 或 application_session_id 时仅返回最近 24 小时事件,返回 call_leg_id、call_session_id、event_timestamp、metadata、name、record_type、type 等字段。
  2. 账本计费组报告:POST /ledger_billing_group_reports 创建(可选 month、year),GET /ledger_billing_group_reports/{id} 查询,返回 created_at、id、organization_id、report_url、status(pending/complete/failed/deleted)等。
  3. 消息批量明细报表(MDR):列出、创建(必填 start_time、end_time,可选 connections、directions、filters、include_message_body 等)、查询单条、删除。
  4. 语音批量明细报表(CDR):列出、创建(必填 start_time、end_time)、获取可用字段(Billing、Interaction Data、Number Information、Telephony Data)、查询单条、删除。
  5. 用量报表:MDR 用量报表、telco 数据用量报表(number_lookup)、CDR 用量报表的列表、创建、查询与删除。
  6. 电话号码 CSV 下载:列出、创建、查询。

使用方式:先安装 pip install telnyx,再通过 from telnyx import Telnyx 初始化客户端,api_key 可取自环境变量 TELNYX_API_KEY。列表方法返回自动分页迭代器,可用 for item in page_result 遍历所有页。

限制与注意事项:所有 API 调用可能因网络错误、限流(429)、校验错误(422)或认证错误(401)失败,生产代码需处理异常,如 telnyx.APIConnectionError、telnyx.RateLimitError(建议指数退避并检查 Retry-After 头)、telnyx.APIStatusError。常见错误码:401 无效 API 密钥、403 权限不足、404 资源未找到、422 校验错误、429 限流。其他定价、配额或平台细节暂未提供。