用途:该技能聚焦 Telnyx 电话号码合规管理,通过 Go SDK 示例演示如何管理监管要求(regulatory requirements)、号码捆包(billing/user bundles)、支持文档(documents/document links)以及电话号码订单的合规适配,适合需要在 Go 项目中集成 Telnyx 合规能力的开发者。
主要能力:
- 捆包定价:列出可用计费捆包、按 ID 获取捆包、获取与创建用户捆包、查询未使用的用户捆包、获取或停用用户捆包、查看用户捆包资源。
- 文档管理:创建、检索、更新、删除、下载文档;生成临时下载链接;列出文档与文档链接。上传文件须在 30 分钟内关联到服务,否则将被自动删除;已关联服务的文档需先解除关联才能删除。
- 合规要求:查询电话号码的监管要求、查询监管要求、创建/查询/更新/删除要求组、提交要求组审批、列出要求类型等。
- 号码订单合规:更新电话号码订单的要求组。
使用方式: 安装:go get github.com/team-telnyx/telnyx-go。初始化客户端时使用 option.WithAPIKey(os.Getenv("TELNYX_API_KEY")) 配置 API Key。所有示例假定 client 已初始化。
限制与注意事项:
- 电话号码须为 E.164 格式(如 +13125550001),包含 + 与国家代码,不能含空格、短横线或括号。
- 分页可使用 ListAutoPaging() 自动迭代。
- 生产代码需处理错误:401 无效 API Key、403 权限不足、404 资源不存在、422 校验错误、429 限流(指数退避重试)。
- 具体收费、价格、平台覆盖、SLA 或使用效果等资料暂未提供。
- 上述能力均基于 Telnyx API 与 Go SDK,需自行申请并配置有效的 API Key。