
如果只需要一次成功的测试调用,选择 fax API 很容易。真正的难题在上线之后:应用如何得知收到了 fax,以及如何找回遗漏的事件。本指南从 API 覆盖范围、webhook、测试和部署方式四个方面对比十家服务商。
| 服务商 | API 与访问模式 | webhook 与通知模式 | 值得考察的适用场景 |
|---|---|---|---|
| Fax.Plus | cloud REST API(Enterprise),支持企业成员、号码和联系人管理;面向 AI 助手的托管 MCP 服务器(付费套餐) | 自助管理端点、签名 webhook、事件目录、按号码路由、入站页面事件、投递日志、重放、自动重试以及端点故障提醒 | 希望在一个 cloud 平台中实现应用工作流、账户/号码操作、webhook 恢复以及 AI 智能体 fax 任务的团队 |
| eFax Enterprise | REST API、OAuth 2.0、账户与号码开通;私有开发者门户 | 支持入站和出站通知;其开发者门户包含沙盒环境。较早的门户资料提到可选的 HMAC 身份验证 | 通过 eFax Corporate 服务评估 API 和沙盒环境的大批量使用组织 |
| iFax | 使用账户 API 密钥的 REST/JSON API | 全局发送和接收 webhook URL;API 指南记载最多重试五次,重试间隔逐步增加 | 需要通过单一账户密钥完成发送、接收、状态查询和号码管理调用的团队 |
| Retarus | 区域性 REST API;其产品文档中还提供 SOAP | 按任务推送 HTTP 状态或发送电子邮件报告;HTTP 推送支持 Basic、Digest 或 OAuth 2.0 身份验证 | 需要区域性端点和可配置投递状态报告的企业级集成 |
| Concord | 企业级 Web 服务和应用集成 API;部分资料需要登录开发者门户才能查看 | 公开的技术资料介绍了推送和拉取两种投递方式。其通知指南建议,如果推送延迟,可将轮询作为备用方案 | 正在评估成熟的文档交换或医疗保健集成方案的组织 |
| InterFAX | 适用于发出和接收 fax 工作流的 REST API | API 参考文档包含状态回调和回调重发操作;请确认当前的重试和签名行为 | 希望使用同时支持接收和发送操作的直接 REST 工作流的开发者 |
| WestFax | 提供自助式模拟沙盒和可复制示例的 REST API | 回调用于通知已完成的发送任务和已收到的 fax。接收方需另行获取详细状态或文档 | 希望在设置账户之前先基于模拟响应进行原型开发的开发者 |
| RightFax / OpenText Fax | 适用于本地部署、混合或私有 cloud fax 基础设施的 Web API | 当前版本图表记载了 Web API 的重试次数和重试间隔属性;未说明公开的自助式 webhook 操作 | 需要掌控现有 fax 服务器环境或采用混合部署的组织 |
| Documo | 基于 API 和门户的 cloud fax 工作流;可在账户或 fax 号码级别设置 webhook | 文档记载了七次计划内重试,之后会发送电子邮件提醒。可启用 Basic 身份验证 | 在账户或 fax 号码级别路由事件的团队 |
| SRFax | 使用账户凭据的 HTTPS POST API;返回 JSON 或 XML 响应 | 文档记载了发送状态回调,并可使用轮询作为备用方案 | 能够适配基于操作的 API 以及“回调加轮询”模式的集成 |
对于优先采用 cloud 的团队,Fax.Plus 位居首选;其他服务则更适合较为特定的集成或部署需求。合适的候选名单取决于您需要掌控多少工作流、应用如何从中断中恢复,以及您希望使用 cloud 服务,还是连接到自行运维的 fax 基础设施的 API。
API 支持发送 fax,并不意味着它适合生产工作流。请通过以下问题评估完整的集成方案:
发送 fax 只是其中一步。双向应用可能还需要接收入站 fax、列出 fax、下载文档、查看传输状态、管理号码,以及停止或重新发送任务。在比较端点数量之前,请先从头到尾梳理您的应用所需的工作流。
接着请确认 fax 文档本身是如何传递的。有些回调包含有用的元数据,但需要应用通过另一次 API 调用来获取 PDF 或 TIFF。这种分离有助于提升安全性并控制负载大小,但您的集成需要存储事件、获取文档,并处理临时下载失败的情况。
“沙盒”的含义可能大不相同。它可能返回模拟响应、接受测试号码、发送真实的 fax,或者只能用来测试账户设置。请问清楚它会模拟生产环境的哪些部分、测试账户是否具备相同的功能和限制,以及服务商会保留哪些数据。
Fax.Plus API 沙盒访问权限可通过 API 联系表单申请,由团队为您安排。对于其他服务商,请询问其沙盒是发送真实 fax 还是返回模拟响应。
如果收件方的 fax 机占线,fax 服务商可能会重试传输。如果您的服务器在接收状态通知时超时,服务商可能会重试 webhook。这是两个独立的队列,失败原因和恢复操作各不相同。
对于符合条件的多页传输,Fax.Plus 还提供“Auto Resume on Partial Send”设置。启用后,可从下一个未发送的页面继续传输,因此收件方可能会分多次收到该 fax。这属于 fax 投递行为,与 webhook 重试或重放无关。
您的 webhook 接收端应快速返回成功的 HTTP 响应,保存或排队事件,并以异步方式处理。它还应能容忍重复事件:一次重试可能多次投递同一事件,而重放会重新发送您的系统未处理的事件。在软件领域,安全地处理同一事件而不重复工作被称为幂等性。
webhook 是某个服务在事件发生时自动向您的应用发送的 HTTP 请求。您的系统无需反复询问“那份 fax 发完了吗?”,而是在服务商有更新时收到一条消息。
至少要检查服务商是否会针对出站完成和入站 fax 发送事件。然后查看负载内容以及每种状态的含义。“fax 已发送”事件可能只表示 fax 任务已结束,并不代表成功。您的应用仍需检查实际的投递状态。
某些工作流可从页面级事件中受益。例如,团队可以在发送方传完所有页面之前,就开始审阅入站的转诊资料包。Fax.Plus 的文档记录了启用 Fax Streaming 后的页面接收事件。Documo 的事件参考中也列出了入站页面事件。请确认完整文档如何获取,以及页面事件先于已完成 fax 记录到达时会发生什么。
HTTPS 在数据于服务器之间传输时保护连接。签名则为您的接收端提供了另一层校验:它可以验证请求是使用服务商共享的密钥签名的,并且请求正文未被更改。Fax.Plus 的文档记录了其当前 webhook API 采用 HMAC-SHA256 签名,并配有针对各端点的密钥和时间戳校验。eFax 较早的 API 门户指南介绍了可选的 HMAC 身份验证。Retarus 在 HTTP 状态推送上支持多种身份验证选项,包括 Basic、Digest 和 OAuth 2.0。
无论选择哪家服务商,都请确认哪种身份验证选项适用于您所购买的具体 API 版本和产品。在支持签名的情况下,不要将 IP 白名单或难以猜测的 URL 当作验证签名消息的替代方案。
重试有助于应对临时故障,但无法解答所有支持问题。投递日志可帮助工程师查看服务是否发送了事件、您的端点返回了什么响应,以及服务商是否会再次尝试。重放则允许获得授权的用户在修复接收端后重新发送遗漏的事件。
Fax.Plus 提供 webhook 投递日志、自动重试、端点故障提醒以及自助重放功能,包括重放所选时间范围内的事件。Documo 会在其预设的重试次数用尽后发送一封电子邮件。InterFAX 的 API 参考文档中包含重新发送回调的方式。对于其他服务商,请要求查看其生产环境日志和重放工作流,并确认重试是自动、手动,还是两者兼有。
如果您的应用支持多个客户、部门或 fax 号码,请询问如何将 webhook 端点分开。fax 门户中的号码到团队设置,不一定等同于按 fax 号码筛选 API 事件。
Fax.Plus 支持按事件和号码筛选,其门户可管理多个端点,有助于团队在不同 fax 号码和工作流之间路由事件。Documo 提供了账户级和号码级 webhook 设置的文档。WestFax 提供了按线路配置回调的文档。此外,还请确认新号码如何继承设置。
Fax.Plus 是一款 cloud fax API,适合希望从自身应用中收发 fax、管理企业账户并处理事件投递的团队。签名功能内置于同一套件:收件箱或已发送文件夹中的任何 fax 都可以转发到 Sign.Plus(Alohi 自家的电子签名产品),在同一账户下自行签署或请他人签署;移动应用还支持签署收到的 fax 并直接发回。
其 webhook 体验包括事件订阅、按号码路由、端点专属的 HMAC 签名、投递标识符、事件目录、投递日志、自动重试、针对失败事件或所选时间范围的重放,以及端点开始出现故障时的提醒。借助号码筛选,每个端点只会接收其所列 fax 号码的事件,因此服务多个客户的平台可以为每个客户的号码分配独立的端点和密钥。Fax Streaming 还增加了入站页面通知。团队可以在门户中查看投递尝试,并在目标就绪后重放事件,从而更便于排查漏收的通知,或在多个 fax 号码之间路由事件。其当前的 API 在过渡期间与旧版 webhook API 并行提供;实现细节请参阅 webhook 文档。
除 fax 操作外,REST API 还可处理账户管理:企业成员、角色和 fax 配额、邀请、fax 号码购买与分配,以及联系人和群组,全部通过 Enterprise API 上受权限范围限制的端点完成。请参阅账户、号码管理和号码购买参考文档。
Fax.Plus 还在其状态页面上公布平台可用性,团队可在此查看服务更新。
在发送和规模方面,API 支持在一次发送请求中指定一个或多个目标,并可配置 fax 传输的重试次数和延迟,如发送 fax 示例所示。启用后,Fax.Plus 还为符合条件的多页 fax 提供 Auto Resume on Partial Send。Fax.Plus 在其定价详情中公布了各套餐级别的页数、文件和并发传输限制,Enterprise 则提供更高容量的选项。fax 状态记录和确认报告有助于核对单次传输的结果。
无需自定义后端集成的团队,也可以使用 Zapier 等无代码应用连接。对于受支持的工作流,这是一种实用的替代方案。
启用 fax 流式传输 后,入站 fax 的每一页一经接收,Fax.Plus 就会发送一个 事件,并且该页会立即以单页文件的形式通过 API 提供。接收系统可以在其余页面仍在传入时,就根据第 1 页对转诊文件包进行分类或路由,而无需等待完整文档。流式传输可应要求为整个账户启用,并且适用于 HIPAA 账户,此时事件携带的是 fax 详情而非文档内容。
Model Context Protocol(MCP)使兼容的 AI 助手能够连接外部工具。Fax.Plus 提供托管的 MCP 服务器,让助手可以通过自然语言请求发送 fax、查看收到的文档、跟踪投递情况并管理联系人。一个端点即可适用于各受支持的 MCP 客户端,因此团队无需为每个助手单独维护连接器,就能在 AI 工作流中使用 fax 操作。OAuth 适用于 Fax.Plus 付费套餐;Enterprise 还支持可配置权限范围的 Personal Access Tokens。MCP 适用于由助手主导的 fax 任务,而 REST API 适用于由应用控制的工作流,例如 webhook 配置、号码开通和企业成员管理。详细了解 Fax.Plus MCP 服务器及其开发者文档。
REST API 和 webhook 适用于 Enterprise 套餐,而 MCP 适用于从 Basic 起的付费套餐。详细了解 Fax.Plus Enterprise 及其 HIPAA fax 工作流。
最适合:以 cloud 为先、需要 REST API 自动化、可恢复的 webhook 运维,以及将 fax 操作直接连接到 AI 助手的团队。
eFax Enterprise 将 cloud REST fax API 与账户和号码开通功能结合在一起。其公开的 API 页面介绍了 OAuth 2.0、收发 fax、fax 图像和元数据获取、webhook,以及带沙盒的私有开发者门户。Fax.Plus 也通过其 REST API 提供成员和号码管理;已在使用 eFax Corporate 并偏好其私有开发者门户模式的组织,可能更适合 eFax。
API 页面介绍了安全的入站和出站通知。另有一份门户快速入门指南,说明了如何通过提交的 URL 接收 fax,并指出可以要求使用 HMAC 身份验证。由于该指南早于当前的营销页面,请向 eFax 咨询:在您所询价的 API 环境中,有哪些签名、沙盒、事件和投递日志功能可用。该门户为私有门户,开发者可能需要先拥有账户或联系销售人员,才能查看完整的参考文档。
最适合:需要托管式 cloud fax 服务的大型组织,包括基于 API 的 fax 发送、账户管理和号码开通。
iFax 发布了 REST API 参考文档,涵盖 fax 发送、已接收 fax、状态查询、文档下载和号码操作。它使用账户 API 密钥并返回 JSON 响应。文档还介绍了 webhook 的行为:针对已发送和已接收 fax 的全局 URL、fax 完成后的 postflight 通知,以及最多五次重试,并附有公布的退避时间表。
全局事件 URL 适合简单直接的账户级设置。需要签名请求、重放或投递历史工具的团队,应向 iFax 咨询这些控制功能如何适配其账户和集成方案。
最适合:希望采用 API 密钥 REST 集成并使用账户级 webhook URL 的开发者。
Retarus 提供面向应用程序 fax 发送的区域化 REST API,同时还提供其他企业集成选项。其手册介绍了可以轮询或推送到客户端点的状态报告。您可以为单个任务设置 HTTP 状态推送 URL,也可以配置默认的账户 URL。文档中列出的身份验证方式包括 Basic、Digest 和 OAuth 2.0。状态报告最多可保留 30 天供检索,或保留至被手动删除。
这适合需要区域化端点、报告保留以及将身份验证作为托管服务一部分进行配置的组织。Retarus 要求开发者联系该公司获取测试账户。其公开手册没有介绍 webhook 投递重放或逐事件的仪表板,因此请询问在您评估的服务中,如何监测并恢复端点故障。
最适合:希望在由服务商主导的集成中获得区域化服务选项和可配置状态投递的企业团队。
Concord 的开发者资料涵盖 fax 和文档交换集成,包括通过 HTTP 推送或拉取来接收传入文档并返回已处理文件的 API。部分开发者资源需要登录门户,且公开资料分散在不同的文档区域和 API 代际中。在比较端点细节之前,请先确认您将使用哪个 Concord 产品、API 版本和部署方式。
一份公开的出站通知指南建议实现基于拉取的状态检查,作为推送的备份。指南指出,推送可能延迟数分钟,或在目标服务器不可用时被延迟。请规划对账路径,而不要假定每条通知都会在您的应用期望的时刻准确送达。请向 Concord 咨询您所考虑的具体服务当前的 webhook 身份验证、重试、重放和投递日志详情。
最适合:正在评估 Concord 更广泛的文档交换和企业集成能力的组织,尤其是 fax 只是更大项目一部分的情况。
InterFAX 发布了针对出站和入站 fax 操作的 REST 参考文档。文档涵盖发送、获取状态、处理入站文档以及其他任务管理操作。其 API 参考还包含回调重发操作,为开发者提供了一条有文档记载的途径来再次请求回调。
在围绕它构建方案之前,请先弄清它涵盖哪些回调事件、失败的投递是否会自动重试,以及您的团队如何查看过往尝试记录。需要签名回调、过滤和门户重放的团队,应确认这些控制功能在其计划使用的 InterFAX 服务中如何运作。
最适合:希望为入站和出站 fax 工作流使用直接 REST API,并且能够与服务商确认回调操作的开发者。
WestFax 的开发者门户提供免费的沙盒凭据、遵循生产环境请求路径和响应结构的模拟 REST API,以及开发者可直接复制的示例。借助沙盒,团队无需发送真实 fax 即可模拟回调结果。
快速入门指南将出站流程分为两部分来说明:任务完成时 WestFax 调用一个 URL,然后应用通过另一次 API 调用获取每位收件人的详细状态。入站回调同样只是告知应用有 fax 到达,随后应用再获取元数据和 PDF。指南建议快速返回成功响应并异步处理工作;同时建议采用幂等处理,因为响应缓慢的端点可能会再次收到回调。上线前,请确认生产环境的身份验证、回调重试计划、签名选项和事件重放。
最适合:希望在开通生产访问权限之前,先在模拟环境中构建并验证 API 逻辑的开发者。
RightFax 现已由 OpenText 以 OpenText Fax 的名称推广。OpenText 介绍了本地部署、混合部署和私有 cloud 部署选项。因此,对于已经运营 fax 基础设施或需要掌控 fax 服务器运行位置的组织,它是相关的选择,但这与托管式、自助服务的 cloud API 属于不同类型的比较。
OpenText 的版本对比表记录了 Web API 的增强功能,包括可配置的重试次数和重试间隔属性。早期的产品文档介绍了用于发送、接收、查询状态、路由、转发、重试和取消 fax 的 API 操作。详细的 API 参考通常与服务器版本和客户访问权限相关联,因此请与 OpenText 或其实施合作伙伴确认所支持的版本、许可、托管责任和升级路径。
最适合:需要将 API 连接到由客户自行运营或混合部署的 fax 服务器环境的组织。
Documo 的 webhook 文档介绍了可在账户或 fax 号码级别进行配置、涵盖多种入站和出站 fax 事件,并支持可选的 HTTP Basic 身份验证。它公布了重试计划:在较长的退避时间窗口内共重试七次。如果所有尝试均失败,文档称会发送一封包含错误和 webhook 数据的电子邮件。事件参考文档中还列出了 webhook 请求完成和失败事件。
webhook 只是文档流程的一部分。入站事件可能逐页到达,而应用程序可通过 API 获取 fax 文件。请规划将事件处理与文档下载分开进行,并确认权限、保留期限和重试在您的账户中的具体表现。Documo 的公开资料同时包含门户设置说明和 API 参考;请确保您的团队查阅的是其报价中包含的确切产品和 API 配置。
最适合:希望按号码级别路由 webhook,并通过单独的 API 步骤获取文档的团队。
SRFax 的开发者指南介绍了一种返回 JSON 或 XML 响应的 HTTPS POST API。其基于操作的接口涵盖将 fax 加入队列、查询一个或多个 fax 的状态、获取收件箱和发件箱项目、下载 fax 文件以及管理排队任务。该服务商还发布了可下载的客户端类和示例。
对于出站更新,SRFax 记录了一个 sNotifyURL 参数,在任务加入队列后,会将 fax 状态字段 POST 到指定的 URL。API 文档称,如果错过了通知,开发者仍可轮询状态。这种回调加轮询兜底的方式可行,但公开指南并未提供与现代事件门户相当的运维细节。请咨询入站通知、回调身份验证、投递重试,以及您的账户是否提供日志或手动重放选项。
最适合:习惯使用基于操作的 API、可下载代码示例,并能接受以轮询作为出站状态通知兜底方案的团队。
API 协议只是决策的一部分。部署模式会影响实施、归属权、支持和迁移。
这些类别之间存在重叠。一个服务商可能提供多种交付路径,而托管的 cloud 服务同样需要技术接入。请让供应商将您报价中的确切产品和部署方式,与您正在查阅的 API 文档一一对应。
从以下关键方面对比各服务商:
对于需要应用程序 API、可运维的 webhook 以及通往 AI 智能体工作流路径的 cloud 优先团队,Fax.Plus 是我们的首选推荐。其 REST API 支持由应用程序控制的 fax 操作。带签名且可过滤的 webhook 让团队能够掌握事件投递与恢复情况。托管的 MCP 服务器可将兼容的助手连接到日常 fax 任务。这些能力结合在一起,让团队在一个平台上同时拥有成熟的后端集成和新型对话式工作流。
其他服务商适合较为特定的需求:eFax 适合已使用其 Corporate 服务的组织,RightFax/OpenText 适合需要客户自行运营或混合 fax 基础设施的团队。对于希望构建涵盖 API、账户与号码管理、webhook 和 AI 助手的现代 cloud fax 工作流的团队,Fax.Plus 是本次对比中综合表现最强的选择。使用 Fax.Plus API 进行应用集成,并使用 MCP 将 fax 引入 AI 辅助工作流。
对于希望在同一个 fax 平台上实现 API 自动化、webhook 运维和 AI 智能体接入的 cloud 优先型组织,Fax.Plus 是我们的首选推荐。其 REST API 支持由应用程序控制的工作流,其 webhook 具备送达可见性和重放功能,其托管的 MCP 服务器可将 fax 操作带给兼容的 AI 助手。如果需求是由客户自行运维的 fax 服务器或混合部署,RightFax/OpenText 更为合适。
“批量”可能指向多个目的地发送同一份 fax、一批独立的 fax 任务,或下载大量已接收的文档。Fax.Plus 支持在一次请求中向多个目的地发送、可配置的 fax 传输重试,以及大批量的 Enterprise 工作流。应用程序可以通过 API 列出 fax 记录并获取 fax 文档。Enterprise 套餐支持更高容量的工作负载;有关页数、文件和并发限制,请参阅价格。
可以。启用 Auto Resume on Partial Send 后,符合条件的多页 fax 可以从下一个未发送的页面继续发送。收件人可能会分别收到原始传输和续传的内容。这与 webhook 重试是两回事。
提供。可通过 Fax.Plus API 页面上的联系表单申请沙盒访问权限,由我们的团队为您安排。
RightFax 由 OpenText 以 OpenText Fax 的名称推广,支持本地部署、混合部署和私有 cloud 部署。其 Web API 与该服务器产品相关联,因此在集成时需要将服务器版本、托管方式、许可和升级流程一并纳入规划。
请确认具体的产品、套餐和部署方式能够满足贵组织的安全与隐私要求。询问服务商是否会为 API 工作流签署 BAA、需要哪些功能或设置、文档和 webhook 负载在何处处理、记录保留多长时间,以及如何审计访问。仅凭合规标签并不能判定您的具体工作流是否合适。有关 Fax.Plus 的套餐条件,请参阅 Fax.Plus HIPAA fax 指南。
部分服务商记录了页面级事件。Fax.Plus 记录了启用 Fax Streaming 后的页面接收事件,Documo 则列出了入站页面事件。如果您的应用程序需要在最后一页到达之前采取行动,请确认事件顺序、文档获取路径,以及页面事件重复或延迟时的行为。
