Как я могу создать swagger на основе существующего почтальона? [закрытый]

Я разрабатываю REST API. во время разработки я использовал postman (расширение chrome) для использования и документирования моего API. Замечательный инструмент, и у меня есть большинство конечных точек в нем. Однако, поскольку мы близки к выпуску, я хотел бы документировать этот API в swagger, как бы я это сделал? Есть ли способ, которым я могу создать swagger на основе экспорта postman?

30
postman swagger swagger-2.0 swagger-ui

3 ответов

APIMatic API-интерфейса трансформатор может обрабатывать коллекцию Postman (v1 или v2) в качестве входного формата и производить Swagger 1.2 или 2.0, а теперь OpenAPI 3.0.0 в качестве вывода.

Он имеет свой собственный API и веб-интерфейс.

35

кто-то опубликовал эту ссылку (и удалил ее?): http://restunited.com/

Он принимает postman JSON и преобразует его в swagger. Кажется, это то, что я искал.

7

вы можете использовать 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);
    });
});
2