SuperAPI AI 工具集

telnyx-account-access-ruby

通用与其它

查看项目

更新于 10-16 05:41

技能介绍

用途:该技能面向使用 Telnyx 平台的 Ruby 开发者,演示如何通过 telnyx gem 配置账户层级资源,包括地址、SSO 认证提供商、访问 IP 地址、账单组以及集成密钥,并展示获取电话凭证访问令牌的方法。

安装与初始化:安装命令为 gem install telnyx。初始化使用 Telnyx::Client.new(api_key: ENV["TELNYX_API_KEY"]),默认读取该环境变量。

主要能力:

  1. 地址:client.addresses 支持 list、create、retrieve、delete,以及 actions.validate 校验地址(用于紧急服务),actions.accept_suggestions 接受地址建议。创建时必填 first_name、last_name、business_name、street_address、locality、country_code。
  2. 认证提供商:client.authentication_providers 支持 list、create、retrieve、update、delete;创建需 name、short_name、settings(如 SAML 的 IdP 指纹、entity id、SSO 目标 URL)。
  3. 访问 IP:client.access_ip_address 支持 list、create、retrieve、delete,创建必填 ip_address,可选 description,返回含 status(pending、added)等字段。
  4. 账单组:client.billing_groups 支持 list、create、retrieve、update、delete,name 为可选字段。
  5. 集成密钥:client.integration_secrets 支持 list、create、delete;创建需 identifier、type,可选 password、token、username。
  6. 访问令牌:client.telephony_credentials.create_token 为凭证创建 JWT。

用法要点:分页列表可用 .auto_paging_each 迭代。生产代码应处理错误,常见状态码含 401、403、404、422、429;网络错误可重试,限流建议指数退避。

限制:资料仅提供 Ruby SDK 示例与接口字段说明,未涉及定价、平台支持范围、速率上限具体数值或其他语言实现,这些暂未提供。