用途:在 Java 项目中集成 Telnyx Verify,实现电话号码信息查询与用户验证。主要能力包括号码查询(返回 caller_name、carrier、country_code、national_format、portability 等),以及通过短信、呼叫、闪信呼叫触发 OTP 验证;可按手机号或验证 ID 检索验证记录、校验验证码,并管理验证配置文件(Verify Profile)与消息模板。
安装:Maven 使用 com.telnyx.sdk:telnyx:6.36.0;Gradle 使用 implementation("com.telnyx.sdk:telnyx:6.36.0")。初始化:TelnyxClient client = TelnyxOkHttpClient.fromEnv();
用法要点:电话号码须为 E.164 格式(如 +13125550001),带 + 与国家代码,不含空格、横线或括号。触发验证需提供 phone_number 与 verify_profile_id,可选 custom_code、extension、timeout_secs。校验验证码按手机号时需 code 与 verify_profile_id。列表方法分页返回,可用 .autoPager() 自动遍历,或用 .hasNextPage() 与 .nextPage() 手动翻页。
错误处理:调用可能因网络、429 限流、422 校验、401 认证失败。捕获 TelnyxServiceException,读取 statusCode() 与 getMessage();422 检查必填字段与格式,429 建议指数退避重试。常见码:401 无效 API Key,403 权限不足,404 资源不存在,422 校验错误,429 限流。
适用场景:需要在 Java 服务端完成手机号验证、号码数据补充或验证流程管理的应用。
限制:资料未提供定价、配额、各验证类型的覆盖地区或到达率等信息,具体以 Telnyx 官方为准;示例代码中的 verify_profile_id 等需替换为实际值。