Wie kann ich aus der vorhandenen Postboten-Sammlung eine Prahlerei generieren? [geschlossen]

74

Ich entwickle eine REST-API. Während der Entwicklung habe ich Postman (Chrome-Erweiterung) verwendet, um meine API zu verwenden und zu dokumentieren. Es ist ein wunderbares Tool und ich habe die meisten meiner API-Endpunkte darin. Wie würde ich das tun, wenn wir uns der Veröffentlichung nähern? Wie würde ich das tun? Gibt es eine Möglichkeit, aus dem Postbotenexport eine Prahlerei zu generieren?

StuBob
quelle
Informationen zu C # / DotNet finden Sie in den folgenden beiden Abschnitten: 1. [] c # - Generieren von JSON-Postboten-Sammlungen aus einem WebApi2-Projekt mithilfe von WebApi-Hilfeseiten, die für den Import geeignet sind - Stapelüberlauf; ;; stackoverflow.com/questions/23158379/; ;; ;; 2. []; ;; X.Einführung der Azure API Apps-Tools für Visual Studio 2013 - Das Visual Studio-Blog - Site Home - MSDN-Blogs; ;; blogs.msdn.com/b/visualstudio/archive/2015/03/24/…
AnneTheAgile

Antworten:

81

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 erzeugen.

Es verfügt über eine eigene API, ein Web-Front-End und eine Befehlszeilenversion .

MikeRalphson
quelle
6
Beachten Sie, dass für die Verwendung der Website ein Konto erstellt werden muss.
Ryanwebjackson
unterstützt jetzt Swagger 2.1
OzBob
Dies funktioniert wie ein Zauber, als ich versuchte, meinen Postboten V2.1 json auf swagger 2.0 umzustellen. Aber sie bitten dich, dich zuerst anzumelden.
Sathish
16

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

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

StuBob
quelle
2
RestUnited ist nur kostenlos, wenn <= 5 Endpunkte pro API und <= 3 APIs vorhanden sind.
AnneTheAgile
Der Export (zur Briefträgersammlung oder zur Prahlerspezifikation) unterliegt keiner Einschränkung. Die von Ihnen erwähnte Einschränkung gilt nur für die Erstellung von SDKs und Dokumentationen.
William Cheng
5
Die beste Option für das OP ist apimatic.io/transformer
Waseem Hassan
1
Ich habe gerade versucht, die Standard-Postman-Echo-Sammlung bei restunited zu importieren, aber es würde nicht funktionieren. Vielleicht haben sie sich nicht mit dem Postboten auf dem Laufenden gehalten?
Daraul
Es funktioniert nicht für neue Versionen.
Parisssss
12

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);
    });
});
plotnik
quelle
3
Dies funktioniert jedoch nur mit Postman V1-Sammlungen!
Lukas Knuth