swagger - 如何根据现有的邮递员集合生成 swagger？

Question

我正在开发一个 REST API。在开发过程中，我使用邮递员（chrome 扩展）来使用和记录我的 API。这是一个很棒的工具，我的大部分 API 端点都在其中。但是，当我们即将发布时，我想大摇大摆地记录这个 API，我该怎么做呢？有没有一种方法可以根据邮递员导出生成招摇？

Answer 1

APIMatic API Transformer可以将 Postman 集合（v1 或 v2）处理为输入格式并生成 Swagger 1.2 或 2.0，现在将 OpenAPI 3.0.0 作为输出。

它有自己的 API 和 Web 前端，还有一个命令行版本。

Answer 2

有人发布了这个链接（并删除了它？）：http ://restunited.com/

它接受邮递员 JSON 并将其转换为招摇。这似乎是我一直在寻找的。

Answer 3

您可以将 https://github.com/stoplightio/api-spec-converter 与代码一起使用

var transformer = require('api-spec-transformer');

var postmanToSwagger = new transformer.Converter(transformer.Formats.POSTMAN, transformer.Formats.SWAGGER);

postmanToSwagger.loadFile('/path/to/your.json.postman_collection', function(err) {
  if (err) {
    console.log(err.stack);
    return;
  }

  postmanToSwagger.convert('yaml')
    .then(function(convertedData) {
      // convertedData is swagger YAML string
      console.log(convertedData);
    })
    .catch(function(err){
      console.log(err);
    });
});