用途
该技能面向使用 Go 语言开发、需要将电话号码携入 Telnyx 的场景。它提供了一系列 Go SDK 调用示例，覆盖从携号可行性检查到创建订单、管理 LOA 文档与查询状态的流程。
安装与初始化
安装命令：
go get github.com/team-telnyx/telnyx-go
初始化示例（资料中后续示例均假设 client 已按此初始化）：
import ( "context" "fmt" "os"
"github.com/team-telnyx/telnyx-go" "github.com/team-telnyx/telnyx-go/option" )
client := telnyx.NewClient( option.WithAPIKey(os.Getenv("TELNYX_API_KEY")), )
主要能力
可携性检查
运行可携性检查并立即返回结果。POST /portability_checks。
携号事件
- 列出所有携号事件：GET /porting/events
- 查看指定携号事件：GET /porting/events/{id}
- 重新发布指定携号事件：POST /porting/events/{id}/republish
LOA 配置
- 列出 LOA 配置：GET /porting/loa_configurations
- 创建 LOA 配置：POST /porting/loa_configurations
- 预览 LOA 模板（无需先创建配置）：POST /porting/loa_configurations/preview
- 获取指定 LOA 配置：GET /porting/loa_configurations/{id}
- 更新指定 LOA 配置：PATCH /porting/loa_configurations/{id}
- 删除指定 LOA 配置：DELETE /porting/loa_configurations/{id}
- 预览指定 LOA 配置：GET /porting/loa_configurations/{id}/preview
携号报告
- 列出携号相关报告：GET /porting/reports
- 创建携号相关报告：POST /porting/reports（示例使用 ExportPortingOrdersCsv 类型）
- 获取指定报告：GET /porting/reports/{id}
英国运营商
列出英国可用运营商：GET /porting/uk_carriers
携号订单
- 列出所有携号订单：GET /porting_orders
- 创建携号订单：POST /porting_orders，必填 phone_numbers，可选 customer_group_reference、customer_reference
- 列出所有异常类型：GET /porting_orders/exception_types
- 列出所有电话号码配置：GET /porting_orders/phone_number_configurations
- 创建电话号码配置列表：POST /porting_orders/phone_number_configurations
- 获取指定携号订单：GET /porting_orders/{id}
- 编辑指定携号订单：PATCH /porting_orders/{id}
使用方式
所有示例以 Go 代码形式给出，调用前需初始化 client 并确保 TELNYX_API_KEY 已配置。电话号码必须使用 E.164 格式（如 +13125550001），包含 + 前缀和国家代码，不能包含空格、短横线或括号。分页可使用 ListAutoPaging() 进行自动迭代：iter := client.Resource.ListAutoPaging(ctx, params); for iter.Next() { item := iter.Current() }。
错误处理
所有 API 调用可能因网络错误、速率限制（429）、校验错误（422）或认证错误（401）而失败。生产代码需处理错误，常见错误码：401 无效 API 密钥、403 权限不足、404 资源未找到、422 校验错误（检查字段格式）、429 被限流（使用指数退避重试）。
适用场景与限制
适用于需要在 Go 应用中集成 Telnyx 号码携入流程的开发者。资料未提供费用、价格、平台支持范围或实际使用效果等信息，相关内容暂未提供。