SuperAPI AI 工具集

telnyx-fax-curl

通用与其它

查看项目

更新于 10-16 05:41

技能介绍

用途:该技能提供 Telnyx 可编程传真(Programmable Fax)的 REST API(curl)示例,用于以命令行方式发送、接收和管理传真,以及配置传真应用。

主要能力:管理传真应用(GET /fax_applications 列表、POST 创建、GET/PATCH/DELETE 单个应用,创建需 application_name 与 webhook_event_url,可设 active、anchorsite_override、inbound/outbound、tags、webhook_event_failover_url、webhook_timeout_secs);传真的列表与查询(GET /faxes、GET /faxes/{id})、发送(POST /faxes,必填 connection_id、from、to,可选 media_url、quality、monochrome、black_threshold、store_media、store_preview、t38_enabled、webhook_url 等)、删除(DELETE /faxes/{id})、取消出站传真(POST /faxes/{id}/actions/cancel,适用于 queued、media.processed、originated、sending 状态)、刷新入站传真已过期的 media_url(POST /faxes/{id}/actions/refresh)。

使用方式:先设置环境变量 export TELNYX_API_KEY="YOUR_API_KEY_HERE",请求以 Authorization: Bearer $TELNYX_API_KEY 认证。例如列表传真:curl -H "Authorization: Bearer $TELNYX_API_KEY" "https://api.telnyx.com/v2/faxes"。发送传真示例使用 multipart:curl -X POST -H "Authorization: Bearer $TELNYX_API_KEY" -F "connection_id=234423" -F "contents=@/path/to/file" -F "to=+13127367276" -F "from=+13125790015" -F "quality=high" -d '{"media_url": "https://example.com/document.pdf"}' "https://api.telnyx.com/v2/faxes"。电话号码须为 E.164 格式(如 +13125550001),带 + 和国家代码,无空格、连字符或括号;列表接口分页,可用 page[number] 与 page[size],并检查 meta.total_pages。

Webhook:Telnyx 使用 Ed25519 签名,请求头包含 telnyx-signature-ed25519 与 telnyx-timestamp(时间戳超过 5 分钟应拒绝以防重放),需在 Telnyx 门户获取公钥并用 SDK 的 client.webhooks.unwrap 验证;端点必须在 2 秒内返回 2xx,否则最多重试 3 次,可在门户配置故障转移 URL。事件包括 fax.delivered、fax.failed、fax.media.processed、fax.queued、fax.sending.started。

限制与错误处理:文件超过 50MB 报 file_size_limit_exceeded,超过 350 页报 page_count_limit_exceeded。常见错误码 401 认证失败、403 权限不足、404 资源不存在、422 校验错误、429 限流(建议指数退避重试)。应用被号码占用时删除可能被阻止。具体价格与计费未提供。