用途:该技能面向使用 Ruby 的开发者,演示如何通过 Telnyx Ruby SDK 完成电话号码携入(Porting In)相关操作,包括可携性检查、创建和管理携号订单、配置与预览 LOA 文件、查询携号事件与报告。
主要能力:运行可携性检查(POST /portability_checks);列出、查看和重新发布携号事件(GET /porting/events、GET /porting/events/{id}、POST /porting/events/{id}/republish);管理 LOA 配置的增删改查与预览(/porting/loa_configurations 系列接口);创建和查询携号报告(/porting/reports);列出英国可用运营商(GET /porting/uk_carriers);携号订单的列表、创建、检索、编辑、删除,以及激活、取消、确认等操作(/porting_orders 系列接口);查询异常类型与电话号码配置。
使用方式:先安装 gem install telnyx,然后 require "telnyx" 并用 Telnyx::Client.new(api_key: ENV["TELNYX_API_KEY"]) 初始化客户端。电话号码须使用 E.164 格式(如 +13125550001),包含 + 和国家代码,不含空格、连字符或括号。分页可使用 .auto_paging_each 自动遍历。生产代码应处理网络错误、429 限流、422 校验错误和 401 认证错误等异常。
适用场景:需要在 Ruby 应用中集成 Telnyx 号码携入流程、自动化携号订单管理与状态跟踪的场景。
限制:激活操作仅限美国 FastPort 订单;删除携号订单仅限草稿状态;资料未提供具体收费、价格或平台支持范围等信息。