用途:在号码从 Telnyx 携出(port-out)时,通过 Telnyx Java SDK 管理携出请求,包括列出、查看和更新携出状态,以及处理携出事件、评论、报告和支持文档。
安装:Maven 使用 com.telnyx.sdk:telnyx:6.36.0;Gradle 使用 implementation("com.telnyx.sdk:telnyx:6.36.0")。
初始化:TelnyxClient client = TelnyxOkHttpClient.fromEnv();
主要能力:列出携出请求 GET /portouts,支持过滤器与分页(.autoPager() 自动迭代,或 .hasNextPage()/.nextPage() 手动控制);按 ID 获取单个请求 GET /portouts/{id};列出与查看携出事件 GET /portouts/events、GET /portouts/events/{id},并可通过 POST /portouts/events/{id}/republish 重新发布事件;查询某订单可用的拒绝码 GET /portouts/rejections/{portout_id};列出与创建报告 GET /portouts/reports、POST /portouts/reports(类型 export_portouts_csv)以及获取报告 GET /portouts/reports/{id};管理评论 GET/POST /portouts/{id}/comments;管理支持文档 GET/POST /portouts/{id}/supporting_documents;更新状态 PATCH /portouts/{id}/{status},需提供 reason,可选 host_messaging,可用于授权或拒绝携出请求。
状态枚举:pending、authorized、ported、rejected、rejected-pending、canceled。
错误处理:API 调用可能因网络、限流(429)、校验(422)或认证(401)失败,建议在生产代码中使用 TelnyxServiceException 捕获并处理,429 可等待后指数退避重试。
限制:具体可用字段、过滤器与返回结构以官方资料为准;资料未提供价格、配额或其他未列出的功能。