SuperAPI AI 工具集

telnyx-porting-in-python

编程与开发

查看项目

更新于 10-16 05:41

技能介绍

用途:该技能面向使用 Telnyx 平台办理电话号码携入(Porting In)的 Python 开发者,覆盖可携性检查、携号订单创建与跟踪,以及 LOA(授权书)配置与文档上传等流程。

安装与初始化:pip install telnyx;通过 import os 和 from telnyx import Telnyx 创建客户端 client = Telnyx(api_key=os.environ.get("TELNYX_API_KEY")),后续示例均假定 client 已初始化。

主要能力:调用 client.portability_checks.run(phone_numbers=[...]) 执行可携性检查,返回 portable、fast_portable、not_portable_reason 等;用 client.porting.events 列出、查看、重发携转事件;用 client.porting.loa_configurations 创建、预览、检索、更新、删除 LOA 配置;用 client.porting.reports 创建与查询携转报告(如 export_porting_orders_csv);用 client.porting.list_uk_carriers 列出英国可用运营商;用 client.porting_orders 列出、创建、检索、编辑、删除携号订单,并通过 actions.activate、actions.cancel、actions.confirm 执行激活、取消与提交操作。

使用方式:API 调用需 API Key 鉴权;电话号码须为 E.164 格式(如 +13125550001),包含加号与国家代码,不含空格、短横线或括号。列表方法返回可自动分页的迭代器,可用 for item in page_result 遍历全部页面。生产代码应处理错误:网络错误、429 限流(按 Retry-After 指数退避重试)、401 鉴权失败、403 权限不足、404 资源不存在、422 字段校验错误。

限制:删除携号订单仅限 draft 状态;actions.activate 仅适用于美国 FastPort 订单;其他平台能力与计费信息资料未提供。