用途
Telnyx Porting In - Java 是 Telnyx 提供的 Java SDK 技能，面向需要将电话号码携入（Port In）Telnyx 平台的开发者。它通过 Java 代码示例，展示如何调用 Telnyx API 完成号码可携性检查、创建携号转网订单、管理 LOA（授权书）文档配置以及跟踪转网状态。
安装与初始化
Maven 依赖：
<dependency>
<groupId>com.telnyx.sdk</groupId>
<artifactId>telnyx</artifactId>
<version>6.89.0</version>
</dependency>
Gradle 依赖：
implementation("com.telnyx.sdk:telnyx:6.89.0")
初始化客户端：
import com.telnyx.sdk.client.TelnyxClient;
import com.telnyx.sdk.client.okhttp.TelnyxOkHttpClient;
TelnyxClient client = TelnyxOkHttpClient.fromEnv();
主要能力
可携性检查
调用 POST /portability_checks 立即返回可携性检查结果，返回字段包括 fast_portable、not_portable_reason、phone_number、portable、record_type。
转网事件
- 列出所有转网事件：
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 - 创建报告（如导出转网订单 CSV）：
POST /porting/reports - 检索报告：
GET /porting/reports/{id}
英国运营商
列出英国可用运营商：GET /porting/uk_carriers，返回 cupid、name、alternative_cupids 等字段。
转网订单
- 列出所有转网订单：
GET /porting_orders - 创建转网订单：
POST /porting_orders，必填 phone_numbers，可选 customer_group_reference、customer_reference - 检索转网订单：
GET /porting_orders/{id}
异常类型与电话号码配置
- 列出所有异常类型：
GET /porting_orders/exception_types，包含 ACCOUNT_NUMBER_MISMATCH、AUTH_PERSON_MISMATCH、BTN_ATN_MISMATCH 等枚举 - 列出电话号码配置：
GET /porting_orders/phone_number_configurations - 创建电话号码配置：
POST /porting_orders/phone_number_configurations
使用方式
所有示例假设 client 已按上述方式初始化。电话号码必须使用 E.164 格式（例如 +13125550001），包含 + 前缀和国家代码，不能有空格、短横线或括号。
分页：列表方法返回一页，可使用 .autoPager() 自动迭代，例如 for (var item : page.autoPager()) { ... }；也可手动使用 .hasNextPage() 和 .nextPage()。
错误处理：所有 API 调用可能因网络错误、速率限制（429）、验证错误（422）或认证错误（401）而失败。生产代码应捕获 TelnyxServiceException，并根据状态码处理：401 无效 API 密钥、403 权限不足、404 资源未找到、422 验证错误（检查字段格式）、429 速率限制（使用指数退避重试）。
适用场景
适用于需要在 Java 应用中集成 Telnyx 号码携入流程的开发者，包括批量检查号码可携性、自动化创建转网订单、管理 LOA 文档、生成转网报告以及跟踪转网事件状态等场景。
限制
资料未提供收费、价格、平台兼容性、性能指标或具体使用效果等信息。