Telnyx Numbers Java 是 Telnyx 官方 Java SDK 中的号码管理技能，用于在 Java 应用中完成电话号码的搜索、订购与后续管理，可结合业务系统实现自动化号码开通流程。
用途与主要能力：通过 SDK 调用号码相关接口，覆盖可用号码搜索、号码预订、号码订单创建与状态查询，以及高级订单、号码块订单、评论、国家覆盖、客户服务记录、库存覆盖、移动网络运营商、网络覆盖、非显式号码订单等操作。核心方法是 client.availablePhoneNumbers().list()、client.numberOrders().create()、client.numberOrders().retrieve()，以及 client.numberReservations().create()/retrieve() 等。
使用方式：Maven 依赖为 com.telnyx.sdk:telnyx:6.82.0，Gradle 为 implementation("com.telnyx.sdk:telnyx:6.82.0")。客户端通过 TelnyxOkHttpClient.fromEnv() 初始化。电话号码须使用 E.164 格式，例如 +13125550001，含 + 号与国家代码，无空格、短横线或括号。列表方法返回分页，可用 .autoPager() 自动遍历，或用 .hasNextPage() 与 .nextPage() 手动控制。
适用场景：需要在 Java 后端按区域、特性或覆盖范围选号并下单、预订号码、查询订单状态，或管理号码相关高级订单和号码块订单时使用。
限制：资料仅覆盖 Java SDK 的号码管理接口；错误处理需考虑 401、403、404、422、429 等状态码，429 建议指数退避重试。不要自行虚构参数、枚举、响应字段或 webhook 字段；若所需字段未在技能中内联展示，应先查阅 references/api-details.md。未提及收费、价格与计费方式的资料，本文不提供相关说明。