SuperAPI AI 工具集

telnyx-porting-in-java

编程与开发

查看项目

更新于 10-16 05:41

技能介绍

用途:该技能面向 Java 开发者,说明如何通过 Telnyx Java SDK 完成电话号码携入(porting in)相关工作,包括检查号码可携性、创建携转订单、管理 LOA 文档配置、跟踪携转事件与状态,以及生成携转报告。

主要能力:可携性检查(POST /portability_checks,返回 portable、fast_portable、not_portable_reason 等);创建携转订单(POST /porting_orders,必填 phone_numbers,可带 customer_reference 等);查询携转订单列表与详情;查询携转事件、单个事件及重新发布事件;LOA 配置的增删改查与预览;生成携转订单 CSV 报告并查询报告;查询英国可用运营商;查询例外类型与电话号码配置。

用法:通过 Maven 或 Gradle 引入 SDK。Maven 依赖为 <dependency><groupId>com.telnyx.sdk</groupId><artifactId>telnyx</artifactId><version>6.36.0</version></dependency>,Gradle 为 implementation("com.telnyx.sdk:telnyx:6.36.0")。客户端初始化使用 TelnyxOkHttpClient.fromEnv() 读取环境变量配置。所有 API 调用应处理错误,常见状态码包括 401 鉴权失败、403 权限不足、404 资源不存在、422 校验错误、429 限流(建议指数退避重试)。

数据格式与分页:电话号码必须为 E.164 格式,如 +13125550001,需含加号与国家代码,不能有空格、短横线或括号。列表方法返回分页结果,可用 .autoPager() 自动迭代,或通过 .hasNextPage() 与 .nextPage() 手动翻页。

限制:资料仅涵盖上述接口的 Java 示例,未提供收费、价格、配额或业务审核规则等信息;实际携转可行性、所需资料与时效以 Telnyx 官方为准。