0

私はswagger uiをダウンロードし、ローカルで実験しました。"path"、"body"、"query" などのシナリオで問題なく機能します。しかし、私のユースケースのほとんどは残りのコメントを使用しています。

つまり、/resourcePath/;tags 特定のリソースのタグを取得するための URI です。

これを試してみると、セミコロンを追加するとUIがごちゃごちゃになり、並べ替えられたUIが不正になり、これを超えることはできません。

これは既知の制限ですか？この目標を達成するための回避策はありますか? これへの入力に感謝します..

4

1 に答える 1

1

pathSwagger は、パラメータを中かっこで指定し{tags}、クエリ パラメータを のようにカンマ区切りで指定することを期待していますid=1,2,3,4。一部のフレームワークは区切り文字としてセミコロンを使用しますが、swagger はコンマが好きです。

もっと具体的な例を挙げて、あなたがやろうとしていることをもっと説明できますか? 設計上、API に関するコメントは、操作のdescriptionおよびnotesフィールドに属します。詳細については、 swagger-core wikiを参照してください。

Swagger codegenプロジェクトには、仕様が適切にフォーマットされていることを確認するために使用できるバリデーターがあります。

于 2012-09-11T04:27:16.540 に答える