Comment puis-je générer swagger basé sur postman existant? [fermé]

Je développe une API REST. pendant le développement, j'ai utilisé postman (extension chrome) pour utiliser et documenter mon API. Outil merveilleux et j'ai la plupart des points de terminaison dedans. Cependant, alors que nous approchons de la sortie, je voudrais documenter cette API dans swagger, comment ferais-je cela? Existe-t-il un moyen de générer swagger basé sur l'exportation postman?

30
demandé sur StuBob 2015-07-08 20:02:48

3 réponses

Apimatic API Transformer {[2] } peut traiter une collection Postman (v1 ou v2) en tant que format d'entrée et produire Swagger 1.2 ou 2.0, et maintenant OpenAPI 3.0.0 en sortie.

Il a sa propre API et un frontal Web.

35
répondu MikeRalphson 2018-06-14 09:52:48

Quelqu'un a posté ce lien (et l'a supprimé?): http://restunited.com/

Il accepte postman JSON et le convertit en swagger. Cela semble être ce que je cherchais.

7
répondu StuBob 2015-07-13 15:23:13

Vous pouvez utiliser https://github.com/stoplightio/api-spec-converter avec le code 

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
répondu plotnik 2018-03-19 15:48:38