wake-up-neo.com

Wie kann ich aus dem vorhandenen Postboten eine Prahlerei generieren?

Ich entwickle eine REST API. Während der Entwicklung habe ich Postman (Chrome-Erweiterung) verwendet, um meine API zu verwenden und zu dokumentieren. Wundervolles Tool und ich habe die meisten Endpunkte darin. Allerdings, wie wir uns nähern release Ich möchte diese API in swagger dokumentieren, wie würde ich das tun? Gibt es eine Möglichkeit, aus dem Postman-Export eine Prahlerei zu generieren?

50
StuBob

Jemand hat diesen Link gepostet (und gelöscht?): http://restunited.com/

Es akzeptiert Postman JSON und konvertiert es in Swagger. Dies scheint das zu sein, wonach ich gesucht habe.

9
StuBob

APIMatic API Transformer kann eine Postman-Sammlung (v1 oder v2) als Eingabeformat verarbeiten und Swagger 1.2 oder 2.0 und jetzt OpenAPI 3.0.0 als Ausgabe produzieren.

Es hat eine eigene API und ein Web-Frontend sowie eine Befehlszeilenversion .

55
MikeRalphson

Sie können https://github.com/stoplightio/api-spec-converter mit Code verwenden

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