如何根据现有邮递员集合生成招摇？

Question

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

Answer 1

有人发布了此 link（并删除了？）：http://restunited.com/

它接受 postman JSON 并将其转换为 swagger。这似乎是我要找的。

Answer 2

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

它有自己的 API 和一个 Web 前端，还有一个 command-line version。

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);
    });
});

如何根据现有邮递员集合生成招摇？

How can I generate swagger based off of existing postman collection?

swagger

postman

swagger-2.0