問題タブ [springdoc-openapi-ui]
For questions regarding programming in ECMAScript (JavaScript/JS) and its various dialects/implementations (excluding ActionScript). Note JavaScript is NOT the same as Java! Please include all relevant tags on your question; e.g., [node.js], [jquery], [json], [reactjs], [angular], [ember.js], [vue.js], [typescript], [svelte], etc.
spring-boot - プロキシの背後にデプロイされた springdoc-openapi-ui (Swagger UI) の間違った「生成されたサーバー URL」
springdoc-openapi-ui (Swagger UI) を使用した Spring Boot 2.2 アプリケーションは、HTTP ポートを実行します。アプリケーションは、クラスターの外部からサービスへの HTTPS 要求をルーティングする Ingress を使用して Kubernetes にデプロイされます。
この場合、で利用可能な Swagger UI のhttps://example.com/api/swagger-ui.html
「生成されたサーバー URL」が間違っています - http://example.com/api
。それはする必要がありますがhttps://example.com/api
。
Swagger UI は HTTPS によってアクセスされますが、生成されたサーバー URL は引き続き HTTP を使用します。
springdoc - springdoc のデフォルトの応答クラス
一部のエラー コードについて、API のすべてのエンドポイントにデフォルトのエラー モデルを追加しようとしています。
次の問題を読んで、部分的な解決策を見つけました。
これは、そのカスタマイズ用に作成している Bean です。
そして、私の Error クラスは次のようになります。
問題は、swagger-ui でエンドポイント定義の 1 つを開くと、次のエラーが発生することです。
Could not resolve reference: Could not resolve pointer: /components/schemas/ErrorItem does not exist in document
ErrorItem のスキーマを定義して、swagger-ui で使用できるようにするにはどうすればよいですか?
私は使っている:
- スプリング ブート => 2.2.4.Release
- springdoc-openapi-ui => 1.3.0
- springdoc-openapi-security => 1.3.0
spring - Springdoc Open API UI - BaseLayout が機能しない
質問をする前にhttps://springdoc.org/springdoc-properties.html#springdoc-openapi-core-propertiesを調べましたが、うまくいかないようです。
BaseLayout を使用したいのですが、Open API 仕様の応答のテーマを黒に変更したいと考えていました。
と を使用Spring Boot v2.2.2.RELEASE
してspringdoc-openapi-ui V1.2.30
います。
上記の設定を入れても、デフォルトの設定が反映されません。
swagger - springdoc-openapi の @Parameter に複数の例を追加する必要がありますが、これは指定された例を生成していません
プロジェクトに闊歩ドキュメントを追加しようとしています。Sample.class の @RequestBody に @Parameter の複数の例を追加する必要があります。次のコードは、ドキュメントに記載されている方法です。
生成される yaml 出力は次のとおりです。
これには、コードに従って追加されるべきであった例が欠けているようです
spring - アクチュエーターを groupedOpenApi として追加する
アクチュエータ エンドポイントを、個別に収集される groupedOpenApi として追加できますか?
元 :
ありがとう