1. Zuhause
  2. Frage und Antwort
  3. Verwenden von Swagger-Codegen mit mehreren Swagger-Dateien

Verwenden von Swagger-Codegen mit mehreren Swagger-Dateien

2016-12-06 6 views

Antwort

2

Sie können relative Schemadatei verwenden. z.B.

$ref: 'Pet.yaml'

Ref: https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md#relative-schema-file-example

Wenn die Prahlerei Dateien nicht verknüpft sind/miteinander verwandt sind, dann müssen Sie die Prahlerei Dateien in einer einzigen Datei kombinieren und verwenden tags die Operationen zu klassifizieren. z.B.

Quelle

2016-12-06 05:52:22

+0

@ wing383 Danke, dies legt nahe, dass ein Master-Prahlerei Datei irgendwie angelegt werden soll, dass sie alle miteinander verbindet? Derzeit gibt es sechs JSON-Swagger-Dateien, und alle haben ihre eigenen Informationen und Tags und zusammen definieren sie eine einzige API. Ist das ein ungewöhnlicher Ansatz? – LookingToLearn

+0

Ich habe gesehen, wie Entwickler eine riesige API in kleinere APIs mit mehreren Swagger-Spezifikationen heruntergebrochen haben, um zu vermeiden, dass zu viele Endpunkte/Operationen in einer einzigen API zusammengefasst werden. Die Größe des SDK kann in bestimmten Szenarien zu einem Problem werden. Daher ist es keine schlechte Idee, die SDK-Größe gering zu halten. Ob Sie die APIs zu einem einzigen kombinieren oder nicht, hängt wirklich von Ihrem Anwendungsfall ab. –

+0

Danke, obwohl ich mir immer noch nicht sicher bin, wie man sie für den lokalen Gebrauch kombiniert oder wie $ ref hilft. Ich arbeite mit den Quellen-Swagger-Dateien, obwohl die Firma, für die ich arbeite, irgendwie in eine einzige Datei für die öffentliche Verwendung mit den Dokumenten zusammenfasst. Ich hoffe, das gleiche lokal beim Testen zu tun, das nicht manuell copy-n-paste oder hacket zusammen ein Skript, um sie zu kombinieren. – LookingToLearn

Verwandte Themen

 Verwandte Themen