telnyx-numbers-python

用途：通过 Telnyx Python SDK 搜索、订购和管理电话号码，覆盖号码搜索、下单、预订、进阶订单、号码块、覆盖范围与注释等流程。安装：pip install telnyx。初始化：import os; from telnyx import Telnyx; client = Telnyx(api_key=os.environ.get("TELNYX_API_KEY"))。号码须为 E.164 格式（如 +13125550001），含 + 和国家代码，不得有空格、短横或括号。列表方法返回自动分页迭代器，可用 for item in page_result 遍历。核心能力：client.available_phone_numbers.list() 搜索可用号码（GET /available_phone_numbers）；client.number_orders.create(phone_numbers=[{"phone_number": "+18005550101"}]) 创建号码订单；client.number_orders.retrieve() 查询订单状态；client.number_reservations.create() 创建预订并 retrieve() 查询；client.advanced_orders.list()/create()/retrieve()/update_requirement_group() 管理进阶订单；client.available_phone_number_blocks.list() 查看号码块；client.comments.list() 获取注释。错误处理：需捕获 telnyx.APIConnectionError、telnyx.RateLimitError、telnyx.APIStatusError，常见状态码 401、403、404、422、429，429 时按 Retry-After 退避重试。限制：不要臆造参数、枚举、响应或 webhook 字段；未内联说明的参数需查阅 references/api-details.md；使用附加操作前先阅读可选参数与响应模式章节。其他能力（号码块订单、客户服务记录、移动网络运营商、覆盖查询等）以资料所列 SDK 方法与端点为准，缺失细节暂未提供。