SuperAPI AI 工具集

telnyx-numbers-services-python

编程与开发

查看项目

更新于 10-16 05:43

技能介绍

用途:该技能面向使用 Telnyx Python SDK 管理电话号码相关服务的开发者,覆盖语音通道(Channel Billing)、动态紧急地址(E911)与紧急端点、以及号码语音信箱配置。

主要能力:

  1. 语音通道:查询非美国区域的语音通道(GET /channel_zones)、更新非美国区域语音通道数量(PUT /channel_zones/{channel_zone_id});查询美国区域语音通道(GET /inbound_channels)、更新美国区域语音通道数量(PATCH /inbound_channels);列出全部或指定区域使用 Channel Billing 的号码(GET /list、GET /list/{channel_zone_id})。
  2. 动态紧急地址:列表(GET /dynamic_emergency_addresses)、创建(POST,必填 house_number、street_name、locality、administrative_area、postal_code、country_code)、查询(GET /{id})、删除(DELETE /{id})。
  3. 动态紧急端点:列表(GET /dynamic_emergency_endpoints)、创建(POST,必填 dynamic_emergency_address_id、callback_number、caller_name)、查询与删除(GET/DELETE /{id})。
  4. 语音信箱:查询、创建、更新指定号码的语音信箱设置(GET/POST/PATCH /phone_numbers/{phone_number_id}/voicemail),字段包括 enabled、pin。

使用方式:安装命令为 pip install telnyx;初始化方式为 from telnyx import Telnyx;client = Telnyx(api_key=os.environ.get("TELNYX_API_KEY"))。列表方法返回自动分页迭代器,可用 for item in page_result 遍历。

错误处理:API 调用可能返回 401 无效密钥、403 权限不足、404 资源不存在、422 校验错误、429 限流;建议捕获 telnyx.APIConnectionError、telnyx.RateLimitError、telnyx.APIStatusError,限流时按 Retry-After 头做指数退避重试。

限制:资料未提供具体定价、速率限制数值、可用区域范围或生产环境配额,使用前需查阅官方文档与支持文章。