SuperAPI AI 工具集

telnyx-sip-python

部署与运维

查看项目

更新于 10-16 05:43

技能介绍

用途:该技能基于 Telnyx Python SDK,用于配置 SIP 中继连接、出站语音配置文件以及管理 SIP 基础设施,适用于将 PBX 系统接入 Telnyx 的场景。

安装与初始化:执行 pip install telnyx 安装。初始化示例为 client = Telnyx(api_key=os.environ.get("TELNYX_API_KEY")),API Key 可省略键名,具体以环境变量读取为默认方式。后续所有接口调用均基于该 client 实例。

主要能力:

  1. Access IP Ranges:列出、创建(POST /access_ip_ranges,必填 cidr_block,可选 description)、删除(DELETE /access_ip_ranges/{id}),返回 cidr_block、status 等字段。
  2. Connections:列出全部连接(GET /connections)并检索单个连接(GET /connections/{id}),返回 active、connection_name、outbound_voice_profile_id、webhook 等字段。
  3. Credential Connections:支持列出、创建(必填 user_name、password、connection_name)、检索、更新(PATCH)、删除,并可调用 check_registration_status 检查注册状态,返回 ip_address、last_registration、port、status、transport、user_agent 等。
  4. FQDN Connections:支持列出、创建(必填 connection_name)等操作,涉及 transport_protocol(UDP/TCP/TLS)等字段。

使用方式:以 Python 调用 SDK 各资源对象的 list、create、retrieve、update、delete 方法,列表方法返回自动分页迭代器,可用 for item in page_result 遍历全部页。

错误处理:需处理网络错误(APIConnectionError)、限流(RateLimitError,对应 429,建议指数退避重试并查看 Retry-After 头)、状态错误(APIStatusError,含 401 无效密钥、403 权限不足、404 资源不存在、422 校验错误)。

限制:资料未提供具体定价、配额、平台支持范围及完整字段细节;部分接口的返回字段在资料中被截断。资料未提供的功能、收费与效果不作说明。