用途:该技能面向需要在 Ruby 应用中把电话号码携入 Telnyx 的开发者,提供基于 Telnyx Ruby SDK 的调用示例,覆盖可携性检查、携号订单管理、LOA 配置与文档、携号事件与报告等环节。
安装与初始化:执行 gem install telnyx;在代码中 require "telnyx",并用 Telnyx::Client.new(api_key: ENV["TELNYX_API_KEY"]) 初始化客户端。
主要能力:可运行可携性检查(client.portability_checks.run);列出、查看与重新发布携号事件(client.porting.events.list/retrieve/republish);管理 LOA 配置,包括列出、创建、预览、查询、更新、删除以及预览具体配置(client.porting.loa_configurations);列出与创建携号报告(client.porting.reports);列出英国可用运营商(client.porting.list_uk_carriers);管理携号订单,包括列出、创建、查询、编辑、删除,以及激活(仅限美国 FastPort 订单)、取消、确认提交(client.porting_orders 及 actions)。另可查询异常类型与电话号码配置。
用法要点:电话号码须使用 E.164 格式(如 +13125550001),含 + 号与国家代码,不含空格、短横线或括号。创建携号订单时 phone_numbers 为必填。分页可用 auto_paging_each 自动遍历,如 page.auto_paging_each { |item| puts item.id }。
错误处理:生产代码应处理网络错误(APIConnectionError)、限流(RateLimitError,429 可等待并按指数退避重试)、API 状态错误(APIStatusError,如 422 校验错误)。常见状态码包括 401 密钥无效、403 权限不足、404 资源不存在。
限制:激活操作仅限美国 FastPort 订单;删除携号订单仅限 draft 状态。价格、收费、配额与具体业务效果暂未提供。