用途:Telnyx Numbers Python 技能通过 telnyx Python SDK 调用 Telnyx API,实现电话号码的搜索、订购与管理,围绕号码开通(provisioning)流程展开。
安装与初始化:使用 pip install telnyx 安装;初始化时用 Telnyx(api_key=os.environ.get("TELNYX_API_KEY"))。所有示例假设 client 已按此方式初始化。
主要能力:核心任务包括搜索可用号码(client.available_phone_numbers.list(),GET /available_phone_numbers)、创建号码订单(client.number_orders.create(),POST /number_orders)和查询订单状态(client.number_orders.retrieve())。辅助操作还涵盖号码预留(number_reservations,含创建、查询、延长)、高级订单(advanced_orders,含列表、创建、更新需求组、查询)、可用号码块、评论、国家覆盖范围、客户服务记录、号码块订单、子号码订单、移动网络运营商、网络覆盖等。列表方法返回自动分页迭代器,可用 for item in page_result 遍历全部页面。响应通常有 data 与 meta 包装。
必要用法:电话号码须为 E.164 格式(如 +13125550001),包含 + 前缀和国家代码,不得有空格、短横线或括号。生产代码需处理错误:网络错误 APIConnectionError、限流 429 RateLimitError(按 Retry-After 重试)、校验 422、认证 401、权限 403、资源不存在 404 等。使用未在技能内联展示的参数、枚举或响应字段前,应先阅读 references/api-details.md,不要臆造参数、枚举、响应字段或 webhook 字段。
限制:资料未提供收费、价格、可用国家或号码库存的具体细节;缺少的信息暂未提供。以上接口的具体可选参数与响应模式需以 references/api-details.md 为准。