SuperAPI AI 工具集

telnyx-numbers-config-ruby

通用与其它

查看项目

更新于 10-16 05:41

技能介绍

用途:通过 Telnyx Ruby SDK 管理电话号码配置,覆盖号码查询、更新、删除,以及短信与语音相关设置、批量操作和所有权验证。

主要能力:列出/精简列出电话号码,检索、更新、删除单个号码;查询带短信设置或语音设置的号码;批量更新短信配置及查询批量状态;创建删除、更新号码或更新应急设置的批量后台任务并查询任务状态;验证号码所有权;批量变更号码所属 bundle。

使用方式:先安装依赖 gem install telnyx,然后初始化客户端 client = Telnyx::Client.new(api_key: ENV["TELNYX_API_KEY"])。号码必须使用 E.164 格式(如 +13125550001),包含加号与国家代码,不加空格、短横线或括号。分页可用 page.auto_paging_each 自动遍历。

错误处理:需处理网络错误(Telnyx::Errors::APIConnectionError)、限流 429(Telnyx::Errors::RateLimitError)、认证 401 与校验 422(Telnyx::Errors::APIStatusError)等;限流建议等待并按指数退避重试,可参考 Retry-After。

适用场景:需要在 Ruby 应用中批量或单个管理 Telnyx 号码的短信、语音、连接、标签等配置时使用。

限制:批量更新每次最多一千个号码;批量更新号码接口要求至少提交一个可更新字段;定价、配额与具体平台支持情况暂未提供。