SuperAPI AI 工具集

telnyx-fax-javascript

通用与其它

查看项目

更新于 10-16 03:37

技能介绍

用途:在 JavaScript/Node.js 环境中通过 Telnyx SDK 以编程方式发送和接收传真,并管理传真应用与媒体资源。

安装与初始化:npm install telnyx@6.74.2;使用 import Telnyx from 'telnyx',并以 new Telnyx({ apiKey: process.env['TELNYX_API_KEY'] }) 初始化客户端。

主要能力:

  1. 传真应用管理:list、create(必填 application_name、webhook_event_url)、retrieve、update、delete(若被电话号码占用可能无法删除)。
  2. 传真操作:list、create(必填 connection_id、from、to,可选 media_url、quality、store_media、webhook_url 等)、retrieve、delete,以及 actions.cancel(取消 queued、media.processed、originated、sending 状态的出站传真)和 actions.refresh(刷新已过期的入站传真 media_url)。
  3. Webhook:通过 client.webhooks.unwrap() 使用 Ed25519 签名(telnyx-signature-ed25519、telnyx-timestamp 头)验证事件,事件包括 fax.delivered、fax.failed、fax.media.processed、fax.queued、fax.sending.started。

用法要点:电话号码使用 E.164 格式(如 +13125550001);列表方法返回自动分页迭代器,可用 for await 遍历;发送传真文件上限 50MB、350 页,超出会分别报 file_size_limit_exceeded 与 page_count_limit_exceeded。

错误处理:始终捕获异常,区分网络错误、401 认证错误、403 权限不足、404 资源不存在、422 校验错误和 429 限流(按 retry-after 指数退避重试)。

限制:资料未提供定价、账户配额、具体速率上限数值或非 JavaScript 语言示例,这些内容暂未提供。