用途:该技能面向使用 Go 语言管理 Telnyx SIP 基础设施的开发者,用于配置 SIP 中继连接、凭证连接、FQDN 连接、出站语音配置以及访问 IP 范围,常见于连接 PBX 系统或维护 SIP 中继场景。
安装与初始化:通过 go get github.com/team-telnyx/telnyx-go 安装,使用 telnyx.NewClient(option.WithAPIKey(os.Getenv("TELNYX_API_KEY"))) 初始化客户端,后续示例均基于已初始化的 client。
主要能力:
- 访问 IP 范围:GET /access_ip_ranges 列出,POST /access_ip_ranges 创建(必填 cidr_block,可选 description),DELETE /access_ip_ranges/{access_ip_range_id} 删除。
- 连接管理:GET /connections 列出所有类型连接,GET /connections/{id} 获取连接详情。
- 凭证连接:支持列出、创建(必填 user_name、password、connection_name)、获取、更新(PATCH)、删除,并可调用 POST /credential_connections/{id}/actions/check_registration_status 检查注册状态。
- FQDN 连接:GET /fqdn_connections 列出,POST /fqdn_connections 创建(必填 connection_name)。
使用方式:调用各资源方法,如 client.AccessIPRanges.List、client.CredentialConnections.New、client.Connections.Get 等;分页可使用 ListAutoPaging() 自动迭代。
错误处理:需处理网络错误、401 认证失败、403 权限不足、404 资源不存在、422 校验错误、429 限流(建议指数退避重试)。
限制:资料未提供收费、价格、平台支持范围及具体效果信息;部分字段与枚举细节需参考官方文档。