用途:该技能面向使用 Ruby 的开发者,演示如何通过 Telnyx 官方 Ruby SDK 管理账户访问相关资源,包括访问 IP 地址、地址簿、SSO 认证提供商、账单分组和集成密钥,并创建电话凭证的访问令牌(JWT)。
主要能力与对应接口: 访问 IP 地址:列表 GET /access_ip_address,创建 POST /access_ip_address(必填 ip_address,可选 description),检索、删除均按 access_ip_address_id 操作。 地址:列表 GET /addresses,创建 POST /addresses(必填 first_name、last_name、business_name、street_address、locality、country_code),校验 POST /addresses/actions/validate(必填 country_code、street_address、postal_code),检索、删除,以及接受地址建议 POST /addresses/{id}/actions/accept_suggestions。 认证提供商:列表、创建(必填 name、short_name、settings)、检索、更新、删除,路径为 /authentication_providers。 账单分组:列表、创建、获取、更新、删除,路径为 /billing_groups。 集成密钥:列表、创建(必填 identifier、type)、删除,路径为 /integration_secrets。 访问令牌:POST /telephony_credentials/{id}/token 创建 JWT。
使用方式:安装 gem install telnyx;初始化 client = Telnyx::Client.new(api_key: ENV["TELNYX_API_KEY"])。分页可用 page.auto_paging_each 迭代。
错误处理:生产代码应捕获网络错误、429 限流(配合 Retry-After 与指数退避重试)、422 校验错误、401 无效密钥、403 权限不足、404 资源不存在。
限制:资料未说明计费、配额或具体地区可用性;字段类型与枚举以上述返回结构为准,其余细节暂未提供。