telnyx-webrtc-java

Telnyx Webrtc - Java 技能围绕 Telnyx Java SDK，帮助开发者在 Java 项目中管理 WebRTC 凭据与移动推送通知设置，适用于构建浏览器端或移动端软电话应用。

安装方式：使用 Maven 时添加依赖 com.telnyx.sdk:telnyx:6.89.0；使用 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(); 初始化客户端。后续示例均假定 client 已按此方式初始化。

错误处理：所有 API 调用可能因网络错误、速率限制（429）、校验错误（422）或认证错误（401）而失败。示例展示了捕获 TelnyxServiceException 并根据状态码处理：422 表示校验错误，需检查必填字段与格式；429 表示被限流，建议等待后使用指数退避重试。常见错误码包括 401（API 密钥无效）、403（权限不足）、404（资源未找到）、422（校验错误）、429（限流）。

分页：列表方法返回一页数据。可使用 .autoPager() 自动迭代：for (var item : page.autoPager()) { ... }；也可手动控制，使用 .hasNextPage() 与 .nextPage()。

主要能力包括两组接口：

移动推送凭据（mobile_push_credentials）：

1. 列出移动推送凭据：GET /mobile_push_credentials，返回 alias、certificate、created_at、id、private_key、project_account_json_file、record_type、type、updated_at。
2. 创建移动推送凭据：POST /mobile_push_credentials，必填 type、certificate、private_key、alias。示例使用 Ios 构建器设置 alias、certificate、private_key。
3. 查询移动推送凭据：GET /mobile_push_credentials/{push_credential_id}。
4. 删除移动推送凭据：DELETE /mobile_push_credentials/{push_credential_id}。

电话凭据（telephony_credentials）：

1. 列出全部凭据（On-demand Credentials）：GET /telephony_credentials，返回 created_at、expired、expires_at、id、name、record_type、resource_id、sip_password、sip_username、updated_at、user_id。
2. 创建凭据：POST /telephony_credentials，必填 connection_id，可选 expires_at、name、tag。
3. 获取凭据详情：GET /telephony_credentials/{id}。
4. 更新凭据：PATCH /telephony_credentials/{id}，可选 connection_id、expires_at、name、tag。
5. 删除凭据：DELETE /telephony_credentials/{id}。

适用场景：需要在 Java 服务端或后端中程序化管理 WebRTC 软电话所需凭据、SIP 用户名与密码，以及为 iOS 等平台配置移动推送通知证书与私钥时，可使用本技能提供的 SDK 调用方式与错误处理模式。

限制：资料未提供价格、收费方式、平台运行要求、性能指标或具体业务效果等信息。