Telnyx SETI Ruby 是一个面向 Ruby 开发者的技能示例,用于通过 Telnyx Ruby SDK 访问 SETI(Space Exploration Telecommunications Infrastructure)API。该技能以 Ruby 代码示例的形式,展示如何安装 SDK、初始化客户端、处理错误以及调用具体接口。
用途 该技能主要用于在 Ruby 项目中接入 Telnyx 的 SETI API,并演示如何通过 Telnyx Ruby SDK 完成相关调用。资料中给出的示例包括获取 10DLC 枚举以及检索黑盒测试结果。
主要能力
- 提供 Telnyx Ruby SDK 的安装命令:gem install telnyx。
- 展示客户端初始化方式:使用 Telnyx::Client.new,并通过 ENV["TELNYX_API_KEY"] 传入 API 密钥。
- 提供错误处理示例,覆盖网络错误、限流(429)、验证错误(422)和认证错误(401)等场景。
- 展示具体接口调用示例:GET /10dlc/enum/{endpoint} 对应 client.messaging_10dlc.get_enum(:mno);GET /seti/black_box_test_results 对应 client.seti.retrieve_black_box_test_results。
- 说明黑盒测试结果接口的返回字段:black_box_tests(array[object])、product(string)、record_type(string)。
使用方式
- 安装 SDK:gem install telnyx。
- 在代码中引入:require "telnyx"。
- 初始化客户端:client = Telnyx::Client.new(api_key: ENV["TELNYX_API_KEY"])。资料说明 api_key 为默认参数,可省略。
- 调用接口,例如 client.messaging_10dlc.get_enum(:mno) 或 client.seti.retrieve_black_box_test_results。
- 在生产代码中按示例处理异常,包括 Telnyx::Errors::APIConnectionError、Telnyx::Errors::RateLimitError 和 Telnyx::Errors::APIStatusError。
适用场景 适用于需要在 Ruby 应用中集成 Telnyx SETI API 的开发者,尤其是需要参考 SDK 初始化、错误处理以及 10DLC 枚举和黑盒测试结果接口调用方式的场景。
限制 资料仅提供上述 Ruby 示例,未说明 SETI API 的完整接口范围、认证以外的权限要求、计费方式、速率限制的具体数值、支持平台或运行环境要求。其他功能与细节暂未提供。