用途:这是 Telnyx IoT 的 Ruby SDK 使用技能,面向用 Ruby 构建 IoT/M2M 解决方案的开发者,用于管理 IoT SIM 卡、eSIM、数据套餐和无线连接。
安装与初始化:安装命令为 gem install telnyx;使用 require "telnyx" 后通过 Telnyx::Client.new(api_key: ENV["TELNYX_API_KEY"]) 创建客户端,api_key 可用环境变量提供。
主要能力:覆盖购买 eSIM(POST /actions/purchase/esims,必填 amount)、注册 SIM 卡(POST /actions/register/sim_cards,必填 registration_codes)、批量 SIM 卡操作(列出与查询 GET /bulk_sim_card_actions 及 /{id})、OTA 更新(GET /ota_updates 及 /{id})、SIM 卡操作(GET /sim_card_actions 及 /{id})、SIM 卡数据用量通知的增删改查(/sim_card_data_usage_notifications)、SIM 卡组操作(/sim_card_group_actions)、SIM 卡组的增删改查(/sim_card_groups),以及向组设置或移除 Private Wireless Gateway、设置或移除 Wireless Blocklist;还包含 SIM 卡订单预览(POST /sim_card_order_preview,必填 quantity、address_id)和订单管理(GET/POST /sim_card_orders)。
错误处理与分页:API 调用可能返回网络错误、429 限流、422 校验错误或 401 认证错误;示例用 rescue 捕获 Telnyx::Errors::APIConnectionError、RateLimitError、APIStatusError,限流时建议退避重试。分页可用 page.auto_paging_each { |item| puts item.id } 自动遍历。
限制:资料仅提供 Ruby SDK 示例与接口返回字段,未说明具体收费、价格、速率或使用限制;实际可用功能与权限以 Telnyx 账户和官方文档为准。