1.Eolink

Eolink 是一款转为开发者设计的 API 协作平台，通过 API 研发管理平台能够实现规范管理、测试所有 API ，自动生成 API 文档，统一管理 API 相关数据，帮助团队内部共享工作成果等多种功能。

用户可以给项目关联 Swagger 生成的 JSON 文件地址，Eolink 的 API 研发管理能够远程读取 Swagger JSON 并自动生成 API 文档。

2.NelmioApiDocBundle

使用NelmioApiDocBundle为 API 生成看起来不错的文档。该包支持 PHP、Twig、CSS 等语言。NelmioApiDocBundle 允许您以 OpenAPI 格式的版本 2 为您的 API 生成文档，并提供一个沙箱来与您的 API 进行交互实验。

该包支持 PHP 注释、Swagger-PHP 注释、Symfony 路由需求和 FOSRestBundle 注释。对于模型，NelmioApiDocBundle 支持 JMS 序列化器、Symfony 序列化器、willdurand/Hateoas 库和 Symfony 形式。

3.Swagger

如果您身边有Swagger，请忘记手动 API 文档。它提供了广泛的令人印象深刻的解决方案，用于创建和可视化您的 API 文档以及维护它们，以便它们随着 API 的发展而保持最新状态。

您可以从 API 定义自动生成文档。如果您当前的 API 不包含定义，它们会提供开源 Swagger Inflector，因此您甚至可以在运行时生成 OpenAPI 定义。为了加快整个过程，您可以使用 Swagger Inspector 自动为端点创建 OpenAPI 文件。

您可以使用 SwaggerHub 的版本控制系统维护文档的多个版本。

根据标准规范扩展 API 设计和建模，并以您想要的任何语言为 API 构建可重用且稳定的代码。借助 Swagger，您可以使用他们的交互式文档流程增强开发人员体验，无开销地执行功能测试，并为 API 架构设置和实施样式指南。

3.自述文件

自述文件提供了一种简单的方法来生成和管理交互式和精美的 API 文档。您可以轻松地直接将 API 密钥合并到文档中，自动生成代码示例，并进行实际的 APU 调用而不会混淆。

通过回答您在他们的支持论坛中看到的问题来建立一个强大的社区，允许消费者提出一些编辑建议，并使每个人都了解更改。使用编辑器同步 Swagger 文件、合并建议的编辑并更新内容，以确保您的文档始终得到更新。

自述文件允许您拖放内容;您还可以通过 CSS 自定义所有内容。Markdown Editor、Swagger File Import 和 Theme Builder 是人们喜欢 ReadMe 的众多功能中的一部分。

它甚至允许用户进行 API 调用，然后复制粘贴实际的代码示例。此外，API 日志、API 定义、API Playground 和动态代码片段还有一些其他内容，它们允许您制作参考指南。

自述文件使与您的团队的协作更具互动性，因为他们可以使用版本控制快速建议编辑以保持事物整洁。通过论坛式支持收集客户反馈并认真对待，从而提供出色的客户支持。

5.Widdershins

Widdershins可帮助您根据 OpenAPI 3.0、Semoasa、Swagger 2.0 和 AsyncAPI 1.x 定义创建文档。最新版本中引入了一些更改，包括“承诺”而不是回调，以及直接输出 HTML 和 ReSpec 格式的选项。

Widdershins 使用模板来创建 Markdown 输出，您可以自定义这些模板或将它们复制到特定文件夹。

6.Postman

如果您听说过API，您可能没有听说过 Postman 。

Postman的 API 文档是一个不错的选择，您可以生成即使是机器也能很好阅读的文档。每次实时更改时，它还可以自动使您的 API 保持最新状态，并让您轻松快速地发布文档。

Postman 可以自动提取您的整个示例请求、代码片段、标题等，以使用机器可读的指令和动态示例填充文档。因此，与您想要的任何人共享 API 变得很容易。

通过在您的文档或网站中嵌入按钮“在 Postman 中运行”，可在几秒钟内分享您的所有收藏。这样，任何人都可以通过单击导入文档。通过让您的文档可供任何人使用，包括开发人员、产品经理、测试人员等，从而更广泛地采用 API。