如何基于现有邮递员收藏生成招摇?[关闭]


77

我正在开发REST API。在开发过程中,我使用邮差(chrome扩展名)来使用和记录我的API。这是一个很棒的工具,并且我拥有大多数的API端点。但是,在即将发布时,我想大声地记录一下这个API,我该怎么做?有没有一种方法可以使我根据邮递员的出口而招摇呢?


对于C#/ DotNet,请参见以下两项:1。[] c#-如何使用适合导入的WebApi帮助页面从WebApi2项目生成JSON Postman集合-堆栈溢出;; stackoverflow.com/questions/23158379/; ; ; 2. []; ; 十,Visual Studio 2013的Azure API应用工具介绍-Visual Studio博客-网站主页-MSDN博客;; blogs.msdn.com/b/visualstudio/archive/2015/03/24/...
AnneTheAgile

Answers:


84

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

它具有自己的API和Web前端,以及命令行版本


6
请注意,该站点需要创建一个帐户才能使用。
ryanwebjackson

现在支持swagger 2.1
OzBob

当我尝试将邮递员V2.1 json转换为swagger 2.0时,这就像一种魅力。但是他们要求您先注册。
Sathish

16

有人发布了此链接(并删除了该链接?):http : //restunited.com/

它接受邮递员JSON并将其转换为招摇。这似乎是我想要的。


2
只有每个API拥有<= 5个端点且<= 3个API的RestUnited才免费。
AnneTheAgile 2015年

出口(到邮递员收藏或急速的规格)没有限制。您提到的限制仅用于生成SDK和文档。

5
OP的最佳选择是apimatic.io/transformer
Waseem Hassan

1
我只是想在restunited上导入默认的邮递员回声集合,所以它不起作用。也许他们没有跟上邮递员的最新消息?
daraul

它不适用于新版本。
parisssss

13

您可以将 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);
    });
});

3
不过,这仅适用于Postman V1系列!
Lukas Knuth
By using our site, you acknowledge that you have read and understand our Cookie Policy and Privacy Policy.
Licensed under cc by-sa 3.0 with attribution required.