什么是昂首阔步，它与OData有关系吗？

Question

我熟悉Microsoft堆栈。我将OData用于我的一些restful服务。最近，我在API文档中遇到了Swagger，我试图了解它与OData的关系。它们似乎都是RESTful规范。哪一种应用广泛？

Answer 1

Swagger是一个用于记录API的规范。通过为API创建一个swagger文档，您可以将其传递给swagger UI的一个实例，该实例以简洁、可读的格式呈现文档，并提供调用API的工具。有关更多信息，请参见Swagger.io网站。

OData是用于通过http创建数据服务的规范，它定义了服务应该如何构造以及应该遵循什么模式。例如，使用$top指令提供数据集的前n个结果。OData目前是第4版，但v2文档有一个非常好的概述。

Swashbuckle是一个用于Microsoft堆栈的nuget包，它根据检查代码和额外的元数据，自动为您的API生成swagger文档，以塑造输出文档。

OpenAPI是描述API的规范；Swagger是OpenAPI标准的实现。你可以在这里找到更多细节。

我希望这有助于澄清任何困惑。