用途:该技能提供 Telnyx 号码携转(Porting In)的 Python SDK 调用示例,帮助开发者用代码完成号码可携转性检查、携转订单创建与管理、LOA 文件配置以及携转状态跟踪。
主要能力:运行可携转性检查(client.portability_checks.run),列出、查看、重发携转事件(client.porting.events);创建、预览、查询、更新、删除 LOA 配置(client.porting.loa_configurations);创建与查询携转报表(client.porting.reports);列出英国可用运营商(client.porting.list_uk_carriers);列出、创建、查询、编辑、删除携转订单,并执行激活、取消、确认等动作(client.porting_orders)。
安装与初始化:pip install telnyx。初始化示例:client = Telnyx(api_key=os.environ.get("TELNYX_API_KEY"))。
使用要点:号码须为 E.164 格式(如 +13125550001),带 + 与国家代码。列表方法返回自动分页迭代器,可用 for item in page_result 遍历。需处理网络错误、429 限流、422 验证错误、401 认证错误等,生产代码应捕获 telnyx.APIConnectionError、telnyx.RateLimitError、telnyx.APIStatusError。
限制:激活功能仅限美国 FastPort 订单;删除携转订单仅限 draft 状态;资料未提供价格、平台支持范围、并发限制或完整错误码之外的失败处理细节。