SuperAPI AI 工具集

telnyx-numbers-ruby

通用与其它

查看项目

更新于 10-16 05:41

技能介绍

用途:面向 Ruby 开发者的 Telnyx 电话号码管理技能,覆盖电话号码的搜索、订购、预留与订单状态查询,以及号码区块、覆盖范围和评论等辅助操作。

主要能力:搜索可用电话号码(available_phone_numbers.list,返回 phone_number、record_type、quickship、reservable、best_effort、cost_information 等字段);创建号码订单(number_orders.create,需 phone_numbers,可选 connection_id、messaging_profile_id、billing_group_id);查询订单状态(number_orders.retrieve);创建与查询号码预留(number_reservations.create/retrieve);高级订单的列表、创建、更新需求组与获取;可用号码区块列表;评论列表与创建、标记已读;以及国家覆盖、客户服务记录、号码区块订单、子号码订单等操作。

使用方式:先安装 gem install telnyx,然后初始化客户端:require "telnyx";client = Telnyx::Client.new(api_key: ENV["TELNYX_API_KEY"])。电话号码须使用 E.164 格式(例如 +13125550001),含加号与国家代码,不含空格、横线或括号。分页可用 .auto_paging_each 遍历。生产代码应处理错误,常见状态码包括 401 无效密钥、403 权限不足、404 资源不存在、422 校验错误、429 限流(使用指数退避重试)。

适用场景:需要在 Ruby 应用中自动化号码搜索与采购流程、管理号码预留或查询供应状态与覆盖范围时使用。

限制:不得自行编造 Telnyx 参数、枚举、响应字段或 webhook 字段;资料未内嵌的参数与响应结构需查阅 references/api-details.md;部分高级操作的可选参数与响应模式同样需先读该文档。资料未提供价格、计费详情或具体审核要求。