問題タブ [swagger-editor]

swagger での継承の使用に問題があります。私は次のものを持っています：

UI を表示して [Try This] をクリックすると、ExtendedErrorModel のフィールドが表示されるはずです。ただし、次のように表示されますが、これは正しくありません。

ご覧のとおり、データ型は正しいようです。

ただし、このボックスを試すと、(1 つではなく) 2 つの要求ボックスと、空のドロップダウン ボックスである ExtendedErrorModel に気付くでしょう。

サイト: http://editor.swagger.io/#/

アドバイスをいただければ幸いです、ありがとう、D

Swagger 2.0 を使用して API を定義しようとしています。私のモデルには、オプションの属性を持つオブジェクトがあるため、Swagger タグ「required:false」を挿入しようとしています。

「必須」タグを挿入すると、エディターでエラーが発生し、理由がわかりません..

私の Swagger の定義は次のとおりです。

これは完全に機能しています。ここで、'message' パラメーター (たとえば) がオプションであることを指定したいと思います。だから私は次のことを試します：

そして今、Swagger Editor でエラーが発生しました。

エラーの詳細は次のとおりです。

行:

誰かが私が間違っていることについて考えていましたか?

生成されたサーバー プロジェクトを maven 3.0.5 バージョンを使用して swagger エディターでビルドすると、以下のエラーが発生します。私はmaven 3.3.9も使用しました。それでも同じエラーで失敗します。Java のバージョンは 1.8.0_40 です。このビルドの失敗の理由は何ですか? これは、swagger エディターで uber API 用のサーバー プロジェクトを生成し、maven を使用してビルドすることで簡単に再現できます。

Swagger-UI の dist/index.html ファイルをダウンロードして参照したところ、サンプルの Petstore API が読み込まれました。ただし、一部の機能がどのように機能しているかを理解できないため、それを自分の定義に持ち込むことができません。

1. サンプルの Petstore では、右下に「VALID {...}」ボタンが表示されます。ただし、独自の API 定義に移動すると、それが表示されません。どうすれば有効にできますか?
2. Swagger-UI によってレンダリングされているペットストアの API 仕様を調べるとhttp://petstore.swagger.io/v2/swagger.json、Swagger Petstore の説明の下のセクションにどのように接続されているのかわかりません。

Contact the developer これはメールアドレスと件名を含む mailto リンクです

Find out more about Swagger http://swagger.ioペットストアのjson定義にも、私が使用しているものにも表示されません。

サンプルはどこからこれを拾っていますか?

3. Swagger エディターを使用すると、仕様が別の方法で解釈されます。最も重要なのは、terms of useとのlicense情報を適切に表示することです。Swagger-UI はこれらのプロパティをサポートしていませんか? それらを表示するには、Swagger-UI で何かを有効にする必要がありますか?

2 つの質問:

1. 新しいルートを定義し、ヘッダーに api_key を設定することを要求してそれを保護したい場合security、yaml ファイルでそのルートの下のセクションを指定してそれを行いますか、それとも下parameters(または両方) に配置しますか? ? の下に置くことで機能する場合、下parametersに置くことのポイントは何securityですか?

2. yaml ファイルは、特定のルートが api_key によって保護されていることを示していますが、(私の知る限り)そのキーの値は指定されていません。ルートをインターセプトしてキーの有効性をチェックするカスタム ミドルウェアを作成する必要があるということですか、それとも、swagger ツールの 1 つによって自動生成できるのでしょうか?

ありがとう。