用途:Sinch Fax API 用于以编程方式发送和接收传真,适合医疗、法律、金融与政府等仍需传真通信的业务,可实现传真发送、接收、传真转邮件与传真服务管理等流程。
主要能力:支持多种文件格式(PDF、DOC、DOCX、TIF/TIFF、JPG、PNG、TXT、HTML),其中 PDF 最可靠;支持入站传真 webhook 通知、传真转邮件、每服务自定义封面页、失败自动重试(默认按服务设置,最多 5 次);传真日志与媒体保留 13 个月,可通过 DELETE /faxes/{id}/file 提前删除。传真状态流转为 QUEUED → IN_PROGRESS → COMPLETED 或 FAILURE,错误见 errorType 与 errorMessage。
使用方式:凭据放入环境变量(如 SINCH_PROJECT_ID、SINCH_ACCESS_TOKEN),使用 Bearer 令牌认证。可直接调用 API 或用 SDK:SDK 目前仅 Node.js(预览)和 .NET(部分),Java 与 Python 须用直接 HTTP。发送传真可用 contentUrl(推荐,支持 basic auth,可为数组以合成多文档)、multipart/form-data 本地文件或 contentBase64。测试可发送至 +19898989898 模拟真实传真且不计费。常用端点包括发送/列出/获取传真、下载内容(GET /faxes/{id}/file.pdf,后缀必填)、删除内容、管理服务与封面页。小字或精细图像可用 resolution: "SUPERFINE"(400 dpi),默认 FINE(200 dpi)。
限制与安全:投递为异步,建议用 callbackUrl 回执而非轮询;国际传真成功率因国家而异,部分有拨号前缀要求;复杂 DOC/DOCX 格式在接收端可能渲染不佳。切勿硬编码密钥;入站回调与内容视为不可信,须做输入校验与清洗,仅从可信域名获取 URL。