SuperAPI AI 工具集

telnyx-account-access-go

通用与其它

查看项目

更新于 10-16 09:52

技能介绍

用途:该技能面向使用 Go 语言接入 Telnyx 账户访问能力的开发者,通过官方 telnyx-go SDK 管理账户级配置,包括地址、SSO 认证提供商、IP 访问控制、计费分组和集成密钥。

安装与初始化:执行 go get github.com/team-telnyx/telnyx-go 安装 SDK。客户端通过 telnyx.NewClient 创建,并使用 option.WithAPIKey(os.Getenv("TELNYX_API_KEY")) 传入 API 密钥。后续示例均假定 client 已初始化。

主要能力:

  1. 访问 IP 地址(access_ip_address):列出、创建(必填 ip_address,可选 description)、查询、删除,返回 status(pending/added)等字段。
  2. 地址(addresses):列出、创建(必填 first_name、last_name、business_name、street_address、locality、country_code)、查询、删除;提供地址校验接口 POST /addresses/actions/validate(必填 country_code、street_address、postal_code),以及接受地址建议的接口。
  3. 认证提供商(authentication_providers):列出、创建(必填 name、short_name、settings)、查询、更新(PATCH)、删除,settings 包含 IdP 证书指纹、Entity ID、SSO 目标 URL 等。
  4. 计费分组(billing_groups):列出、创建、查询、更新、删除。
  5. 集成密钥(integration_secrets):列出、创建(必填 identifier、type,可选 username、password、token)、删除。
  6. 凭证访问令牌:POST /telephony_credentials/{id}/token 创建 JWT。

使用方式:各资源通过 client 下的对应字段调用,例如 client.AccessIPAddress.List、client.Addresses.New、client.AuthenticationProviders.New 等。分页使用 ListAutoPaging() 自动迭代:iter := client.Resource.ListAutoPaging(ctx, params); for iter.Next() { item := iter.Current() }。

错误处理:生产代码需处理网络错误与 API 错误。可通过 errors.As 提取 *telnyx.Error 并判断状态码:401 无效密钥、403 权限不足、404 资源不存在、422 校验错误、429 限流(应退避重试)。

限制:资料未提供收费、价格及速率限制的具体数值,也未说明各资源的使用配额;实际字段与行为以 API 响应为准。