validar - swagger validator

¿Cómo puedo generar el jaleo basado en el cartero existente?

Question

Estoy desarrollando una API REST. Durante el desarrollo, he usado Postman (extensión de Chrome) para usar y documentar mi API. Herramienta maravillosa y tengo la mayoría de los puntos finales en ella. Sin embargo, a medida que nos acercamos al lanzamiento, me gustaría documentar esta API de forma arrogante, ¿cómo podría hacerlo? ¿Hay alguna manera de que yo pueda generar swagger basado en la exportación del cartero?

Answer 1

Alguien publicó este enlace (¿y lo eliminó?): http://restunited.com/

Acepta al cartero JSON y lo convierte en arrogante. Esto parece ser lo que estaba buscando.

Answer 2

Puede usar https://github.com/stoplightio/api-spec-converter con código

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

Answer 3

APIMatic API Transformer puede procesar una colección de Postman (v1 o v2) como formato de entrada y producir Swagger 1.2 o 2.0, y ahora OpenAPI 3.0.0 como salida.

Tiene su propia API y un front-end web.