记录API是构建应用程序的重要部分。它是我们与客户共享的合同。此外，它详细记录了我们的集成点如何工作。文档应该易于访问、理解和实现。

在本教程中，我们将研究Springwolf，用于记录事件驱动的Spring Boot服务。Springwolf实现了AsyncAPI规范，这是OpenAPI规范的事件驱动API的适配。Springwolf是协议不可知的，涵盖了Spring Kafka、Spring RabbitMQ和Spring CloudStream实现。

使用Spring Kafka作为我们的事件驱动系统，**Springwolf为我们从代码生成AsyncAPI文档。**一些消费者会自动检测到。其他信息由我们提供。

---

Swagger中枚举的文档

1. 概述

在本教程中，我们将学习如何使用_swagger-maven-plugin_在Swagger中记录枚举，并在swagger编辑器中验证生成的JSON文档。

2. Swagger是什么？

Swagger是一个开源工具，用于定义基于REST的API。在当今世界，大多数组织都在向微服务和API优先方法发展。Swagger在设计和记录API方面非常有用。它还提供了各种工具，如Swagger编辑器、Swagger UI和Swagger CodeGen来协助API开发。

此外，Swagger是_OpenAPI_规范或_OAS_的实现，它定义了REST API开发的一套标准；因此，它帮助全球组织标准化编写API的过程。