SuperAPI AI 工具集

telnyx-fax-java

办公与效率

查看项目

更新于 10-16 08:41

技能介绍

用途:该技能面向 Java 开发者,演示如何通过 Telnyx Java SDK 以编程方式发送和接收传真,并管理传真应用(Fax Application)与传真媒体。

主要能力:

  1. 传真应用管理:列出、创建、检索、更新、删除传真应用(GET/POST /fax_applications、GET/PATCH/DELETE /fax_applications/{id}),创建时 application_name 与 webhook_event_url 为必填。
  2. 传真操作:列出传真(GET /faxes)、发送传真(POST /faxes,必填 connection_id、from、to)、查看传真(GET /faxes/{id})、删除传真(DELETE /faxes/{id})、取消处于 queued、media.processed、originated 或 sending 状态的出站传真(POST /faxes/{id}/actions/cancel)、刷新已过期的入站传真 media_url(POST /faxes/{id}/actions/refresh)。
  3. Webhook:支持 Ed25519 签名验证,请求头包含 telnyx-signature-ed25519 与 telnyx-timestamp,可用 client.webhooks().unwrap() 校验;事件包括 fax.delivered、fax.failed、fax.media.processed、fax.queued、fax.sending.started。

使用方式:通过 Maven 依赖 com.telnyx.sdk:telnyx:6.36.0 或 Gradle implementation("com.telnyx.sdk:telnyx:6.36.0") 安装;用 TelnyxOkHttpClient.fromEnv() 初始化客户端。电话号码须为 E.164 格式(如 +13125550001)。列表方法返回分页,可用 .autoPager() 自动遍历,或 .hasNextPage()/.nextPage() 手动控制。

限制:发送传真时文件超过 50MB 或超过 350 页会分别以 file_size_limit_exceeded 和 page_count_limit_exceeded 失败。API 调用可能返回 401、403、404、422、429 等错误,生产代码需处理异常并对 429 采用指数退避重试。删除传真应用时若仍被电话号码使用可能被阻止。其余细节暂未提供。