Telnyx Numbers - Go 是 Telnyx 面向 Go 开发者的电话号码管理 SDK 技能，覆盖号码搜索、订购、预留与覆盖查询等流程。
用途 该技能用于通过 Go 代码管理 Telnyx 电话号码，包括按条件搜索可用号码、创建与查看号码订单、创建与查看号码预留，以及查询国家覆盖、库存覆盖、网络覆盖和移动网络运营商等信息。
安装与初始化 安装命令：go get github.com/team-telnyx/telnyx-go。 初始化时导入 github.com/team-telnyx/telnyx-go 与 github.com/team-telnyx/telnyx-go/option，并通过 option.WithAPIKey(os.Getenv("TELNYX_API_KEY")) 传入 API Key。示例中的所有调用均假定 client 已按此方式初始化。
主要能力 核心任务包括：搜索可用电话号码（client.AvailablePhoneNumbers.List()，GET /available_phone_numbers），支持通过 Filter 参数筛选，返回号码、记录类型、Quickship、Reservable、BestEffort、CostInformation 等字段；创建号码订单（client.NumberOrders.New()，POST /number_orders），需传入 PhoneNumbers，可选传入 ConnectionId、MessagingProfileId、BillingGroupId 等；查看号码订单状态（client.NumberOrders.Get()，GET /number_orders/{number_order_id}），返回 ID、Status、RequirementsMet、PhoneNumbersCount、PhoneNumbers、ConnectionID 等。
重要支持操作包括：创建号码预留（client.NumberReservations.New()，POST /number_reservations）与查看号码预留（client.NumberReservations.Get()）；列出进阶订单（client.AdvancedOrders.List()，GET /advanced_orders）、创建进阶订单（client.AdvancedOrders.New()，POST /advanced_orders）、更新进阶订单的 requirement group（client.AdvancedOrders.UpdateRequirementGroup()，PATCH /advanced_orders/{advanced-order-id}/requirement_group）、获取进阶订单（client.AdvancedOrders.Get()，GET /advanced_orders/{order_id}）；列出可用号码块（client.AvailablePhoneNumberBlocks.List()，GET /available_phone_number_blocks）；检索全部评论（client.Comments.List()，GET /comments）。
附加操作还包括评论的创建、获取与标记已读，国家覆盖查询，客户服务记录相关操作，inexplicit number orders，库存覆盖请求，移动网络运营商列表，网络覆盖位置列表，号码块订单，号码订单内电话号码的查询与需求更新，号码订单列表与更新，号码预留列表与延长，以及号码特性查询等。
使用方式 所有电话号码必须使用 E.164 格式，包含 + 前缀与国家代码，不含空格、短横线或括号。分页可使用 ListAutoPaging() 自动迭代：iter := client.Resource.ListAutoPaging(ctx, params); for iter.Next() { item := iter.Current() }。API 调用可能因网络错误、限流（429）、校验错误（422）或认证错误（401）失败，生产代码需处理错误；常见错误码包括 401 无效 API Key、403 权限不足、404 资源未找到、422 校验错误、429 限流（建议指数退避重试）。
限制 不得自行编造 Telnyx 参数、枚举、响应字段或 webhook 字段；若所需字段未在技能内联展示，应先阅读 references/api-details.md。使用 Additional Operations 中的操作前，需先阅读可选参数部分和响应 schema 部分。官方文本与参考资料中未明确说明的功能、收费、价格、平台或效果，本介绍暂未提供。