Как я могу создать чванство на основе существующего почтальона?

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

Ответы

Ответ 1

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

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

Ответ 2

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

Он имеет собственный API и веб-интерфейс, а также версию для командной строки.

Ответ 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);
    });
});