最佳 Apiary 替代方案

Apiary 即将关闭。Oracle 已发布了终止 Apiary 支持的公告，而 API 工具领域的各类报道指出，该托管服务最终将于 2026 年 9 月左右彻底关闭。尽管该网站目前仍能打开，但其发展轨迹早在多年前就已清晰：Oracle 于 2017 年 1 月收购了 Apiary，在 2018 年废弃了付费方案，并任由其周边的开源工具（Dredd、Ga vel）逐渐进入归档状态。如果您的接口文档仍托管在 apiary.io 上，那么您现在面临的已不再是“评估替代方案”，而是必须进行迁移，并且这个截止日期是无法更改的。

明确的结论是：Apifox 是最佳的 Apiary 替代方案。因为它不仅完全替代了 Apiary 的所有功能（基于文档模式的规范编辑、托管的交互式文档、mock 服务端），还补充了 Apiary 从未完善的部分：自动化 API 测试、用于取代已归档 Dredd 的规范驱动校验，以及 CI 集成。它可以免费供最多 4 位用户使用，付费方案起售价为每位用户每月 9 美元。唯一需要注意的限制是，Apifox 无法直接导入 API Blueprint 文件，因此基于 Blueprint 的项目在迁出时需要进行一次性的 OpenAPI 格式转换。本文将介绍 Apiary 当前的状况、包含上述转换步骤的详细迁移路径，以及在 Apifox 不适合您时有哪些其他替代方案。

Apiary 究竟发生了什么

成立于 2011 年的 Apiary 作为一款产品，实际上开创了以文档模式为核心的 API 工作流（design-first API workflow）。它向世界推出了 API Blueprint（一种在 OpenAPI 普及前基于 Markdown 的 API 描述格式），以及由 Stripe 推广并被所有人效仿的三栏式文档布局。它还集成了托管的 mock 服务端、GitHub 同步以及两个备受欢迎的开源契约测试工具：Dredd 和 Ga vel。

随后，Oracle 在 2017 年 1 月收购了它，这款产品也由此进入了相当漫长的沉寂期。到了 2018 年，付费方案被废弃，Apiary 逐渐变成一个免费的遗留服务，而 Oracle 则开始引导企业客户转向自家的 API Platform Cloud。新功能的开发也就此按下暂停键，Dredd 和 Ga vel 相继被归档。如今，正式的终结终于到来：Oracle 已发布终止支持公告，托管服务预计将在 2026 年 9 月左右彻底关闭。发布迁移指南的厂商之一 Bump.sh 在告别贴中说得很直接：请务必在关停前导出您的 API 描述，因为一旦关闭，将不会再有任何数据可供导出。

这会带来两个实实在在的后果。先说第一点，凡是只存在于 Apiary 内部的内容——接口定义、规范、文档内容、团队配置——现在都得尽快导出，趁着导出按钮还正常可用。再看第二点，API Blueprint 后续并没有得到维护工具的延续支持，所以这次迁移其实不只是平台切换，更是一次格式迁移：无论最终落到哪个平台，最稳妥的目标格式，都是 OpenAPI。

你需要替换什么

明确 Apiary 到底为你的团队提供了哪些功能是非常有帮助的，因为替代方案必须涵盖每一个部分：

• 文档模式的规范编辑器。 你在浏览器中编写 API Blueprint（或在后来的项目中编写 OpenAPI 3.0），文档会实时更新。
• 托管的交互式文档。 带有示例请求的三栏式参考文档，托管在 apiary.io URL 上。
• mock 服务端。 每个 Apiary 项目都会获得一个托管的 mock 接口，该接口根据你的接口定义/规范提供示例数据，以便调用方可以在后端开发完成之前进行对接。
• GitHub 同步。 接口定义/规范文件保存在你的 GitHub 仓库中，并进行双向同步。
• 通过 Dredd 进行契约测试。 这是一个开源的 runner，它会针对实际实现重新运行你的接口定义/规范并报告偏差。它目前已被归档；我们在“如何在没有 Dredd 的情况下根据接口定义/规范校验你的 API”中探讨了替代方案问题。

这一整套功能（设计、文档、mock、校验）正是现代 API 开发平台的基本形态。这就是为什么最佳的迁移目标不是一个单纯的文档渲染器，而是一个具有相同形态且在持续活跃开发中的平台。

解决方案：Apifox

Apifox 是一个被超过 50 万开发者使用的 API 开发平台。它涵盖了 Apiary 在 2011 年构想但后来停止构建的完整生命周期：设计、文档、mock、调试和自动化测试，所有这些都由同一个接口定义/规范驱动。

值得一提的是，除了个人和常规团队使用，针对有高安全合规要求、或需要在内网环境协作的企业，Apifox 还提供了深度定制的私有化部署方案。