Swagger-先决条件及其在 node.js 中的作用

Swagger-Pre-requisites and its role in node.js

我想知道在 node.js 中学习 swagger 需要什么先决条件以及在 node.js 中 swagger 的作用是什么。我需要为此学习 YAML 吗?知道在哪里可以找到有关 swagger 及其培训的更多信息会很有帮助。

Swagger 是一种记录 REST 服务的方式。它不依赖于任何服务器端技术。 Swagger 可用于记录使用 Java、Go 或任何其他技术堆栈构建的 Rest 服务。

回答您的问题。

  1. 在 node.js 中学习 swagger 需要先决条件? - - 你应该 非常熟悉您的网络服务的合同部分。它会 如果您对 Json 或 Yaml 文件
  2. 有点熟悉,将会有所帮助
  3. swagger在node.js中的作用是什么? ---- 记录 Rest 服务 使用 NodeJs(或任何其他服务器端技术,为此 事)
  4. 我需要为此学习 YAML 吗? - - 不必要。你可以做 在 Json 或 Yaml 中(我个人的偏好是 Json,因为空格 在那里并没有多大意义)

editor.swagger.io 有一个很好的工具,您可以使用它来验证您的 swagger 规范,在 json 和 yaml 格式之间进行转换等。
看看这里 http://editor.swagger.io/#/ ,玩一下 Uber API.

的 swagger 规范