用途:面向经销商与企业场景,用 Go SDK 管理 Telnyx 托管账户(子账户)及组织用户。资料以代码示例形式给出,不包含概念性说明。
主要能力:托管账户的列表、创建、获取、更新、禁用、启用,以及分配全局外呼渠道限额;查询可分配的全局外呼渠道;组织用户的列表、获取、删除和用户分组报告。创建托管账户必需 business_name,可选 email、password、rollup_billing 等。禁用会阻止该账户及其子用户使用 Telnyx 服务与登录控制台,但不影响进行中的通话;启用可选 reenable_all_connections。成为管理者账户需 Telnyx 明确批准。
使用方式:先安装 go get github.com/team-telnyx/telnyx-go,导入 telnyx 与 option 包,使用 option.WithAPIKey(os.Getenv("TELNYX_API_KEY")) 初始化客户端,再调用各方法。分页使用 ListAutoPaging() 迭代。
限制:错误需处理网络错误及 401、403、404、422、429 状态码,429 建议指数退避重试;权限不足、资源不存在、字段校验失败是常见失败原因。用户分组报告不分页,可返回 JSON 或 CSV。资料未提供定价、配额上限或 SLA 等信息。