用途:该技能面向使用 Telnyx Python SDK 管理电话号码配置的开发者,通过代码示例演示电话号码的查询、更新、批量操以及与语音和消息相关的设置。
安装与初始化:使用 pip install telnyx 安装,然后从环境变量 TELNYX_API_KEY 初始化客户端:client = Telnyx(api_key=os.environ.get("TELNYX_API_KEY"))。后续示例均假设 client 已按此方式初始化。
主要能力:包括列出、检索、更新与删除单个电话号码;批量更新号码资料(POST /messaging_numbers_bulk_updates)及查询批量更新状态;列出与检索带消息设置的移动电话号码和普通电话号码;校验号码归属(POST /phone_numbers/actions/verify_ownership);通过 jobs 接口批量删除号码、批量更新紧急呼叫设置(每次最多 1000 个)以及批量更新号码;还有性能更高的精简列表接口 GET /phone_numbers/slim。号码返回字段涉及呼叫转接、通话录音、来电显示名称、CNAM 列表、连接 ID、消息资料、紧急状态等。
使用方式:所有电话号码须为 E.164 格式,如 +13125550001,包含加号与国家代码,不能有空格、短横线或括号。列表方法返回自动分页迭代器,可用 for item in page_result 逐页遍历。生产代码需处理错误,包括网络错误、429 限流、422 验证错误和 401 认证错误,常见状态码含 401、403、404、422、429。批量操作返回 failed、pending、success 数组和 order_id。
限制:资料未提供定价、速率上限具体数值或其他平台支持信息;批量更新每 API 调用至多一千个号码;号码配置字段需符合接口要求。