Rest 大摇大摆还是api优先

我已经阅读了swagger的定义和格式，并且理解swagger的定义是用来描述api的

---

写招摇过市的定义然后再写API会更好吗？还是先写API，然后大摇大摆？我没有这方面的经验，我想为应用程序编写一个RESTAPI和一个swagger文件。

我认为顺序并不重要。这两种方法都在大摇大摆中获得了合法性。关键是一个应该从另一个生成，所以您不必手动维护这两个

在评论中，cricket_007已经提到了一些工具，这些工具可以从swagger定义生成web服务框架。使用这些工具，首先编写狂妄定义是有意义的。这是《入门指南》中自上而下的方法

从上面链接的《Swagger入门指南》中，您可以看到，如果您使用像JAX-RS这样的特定框架，还可以使用一些工具从java代码生成Swagger文档。这是一种自底向上的方法

这可以归结为个人偏好。如果您是那种不希望将代码库“耦合”到Swagger并确保应用程序不依赖于Swagger工作的人，那么自下而上的方法是最好的。然而，如果你想完全接受招摇过市的工具链并真正“接受”它，那么自上而下的方法可能是最好的

---

此外，如果这是出于教育目的，那么想想你想了解什么。如果您想从头开始学习编写JSON REST API（或使用JAX-RS之类的工具），那么自下而上的方法将教会您更多。但是，如果您的目标是尽可能多地了解Swagger，那么自上而下的方法会更好。

我相信有一些工具可以让您完全基于Swagger定义为新手生成API，编写swagger定义并生成API或先编写API更好吗？文档应该描述API代码函数，而不考虑编程语言，因此这可能是一个更好的开始。也，