問題タブ [swagger-editor]
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.
node.js - Swagger - プロジェクト ディレクトリの変更
ワークスペース内のルート ディレクトリ内に新しいプロジェクト ( nodeJS ) を作成し、しばらくして、プロジェクトのクライアント側とサーバー側を分離したいと考えました。そのために、プロジェクトのルート ディレクトリ内に 2 つのフォルダー (サーバーとクライアント) を作成し、すべてのファイルとディレクトリを適切なフォルダーに移動しました。
その後、Swaggerがswagger.yamlファイルを見つけることができないと表示されるため、サーバーを起動できません(サーバーフォルダーに移動しました)
ノード サーバーの config フォルダー内のdefault.yamlファイルを編集しようとしましたが、問題は解決しません。
swagger プロジェクトの構成を新しいラクション (ディレクトリ -> サーバー フォルダー) にポイントする方法はありますか?
デフォルト.yaml:
編集: app.js を追加
app.js:
node.js - node.js の swagger の null 許容フィールド
Node.JSでswaggerドキュメントを作成するための解決策を見つけるのに多くの時間を費やしました. メイン ライブラリは swagger-node で、swagger yaml ファイルを作成し、コントローラを追加します。アプリにswagger uiドキュメントを自動的に提供し、yamlで指定したモデルに対してリクエストとレスポンスの検証を行います。
これはきちんとしていますが、明示的に値として返したり受け入れたりできるようにしたいいくつかのフィールドが必要ですnull
。たとえば、次のようになります。
キーを削除したくありませんdate_sent
。明示的にnullと宣言したいのです。
swagger 仕様はanyOf
、JSON スキーマが通常これを行う方法をサポートしていません。
回避策があるかどうか疑問に思っていますか?おそらく、追加できるベンダー固有のフラグを持つノードで利用可能なライブラリx-nullable
、または必須ではないフィールドがすべて null 可能であることを指定する方法です。
バリデータミドルウェアが実行される前に、自分のswaggerファイルを取得して変更する何かを自分で作成する必要がありますか、または誰かが提案できる回避策はありますか?
swagger - Swagger 2.0 で本文を介してデフォルト値を送信する方法
こんにちは、本文パラメーターを介してデフォルト値を送信しようとしていますが、送信中に取得できません。誰でもこの問題について私を助けてください。これが私のコードで、本文を介してデフォルトの名前パラメーターを送信しようとしています
swagger - ローカルでswaggerファイルを使用するには?
こんにちは、私は自分の API 用に書かれた Swagger ファイルを持っていますが、API のパスをテストできませんでしたERROR Server not found or an error occurred
。ありがとうございました
swagger - カスタム Restful API (C#.NET) の定義を生成するための Swagger
RESTful api (.net および c#) に swagger を使用しようとしています。これはカスタムの RESTful API です (ASP.NET Web API や Web アプリケーションではありません)。
私は NSwagStudio を使用して仕様を生成する NSwag ( https://github.com/NSwag/NSwag ) を使用していますが、メソッドを仕様化していないため成功しません。他の方法でそれを行う方法はありますか?操作のカスタム属性をswaggerに理解させるにはどうすればよいですか?
swagger - 私は Swagger ツールを初めて使用します。Intellij Idea で Swagger Editor ツールを使用する方法を知っている人はいますか
私は Swagger ツールを初めて使用します。オンラインエディター形式ではなく、Intellij Idea で Swagger Editor ツールを使用する方法を知っている人はいますか?
swagger - Swagger は「有効なパラメーター定義ではありません」と言っています
私は闊歩するのにかなり慣れていないので、学習のための優れたリソースに関する方向性を教えていただければ幸いです。
まとめているテスト プロジェクトがあり、いくつかの問題が発生しています。
「削除」ブロックの「パラメーター」が無効であるというエラーが表示されます。例で見たものから、私には問題ないように見えます。しかし、明らかに私は何かが欠けています。何か案は?
spring - Swaggerで生成されたSpringサーバーコードでPOST RequestBodyからXML文字列を取得する方法は?
POST で送信された XML 文字列を受け取る REST API メソッドを作成したいと考えています。Swagger Editorを使用して、REST API をトップダウンで設計し、サーバー スタブ コードを生成しています。
my の POST メソッドは次のようになりますswagger.yaml
。
yaml ファイルには、次のグローバル設定もあります。
Swagger Editor の[Generate Server] > [Spring ] メニュー オプションを使用すると、POST メソッドに対して次のインターフェイス メソッドが生成されます。
これは、対応するスタブの実装です。
Postman を使用して、実行中の Springboot サービスのメソッドにダミーの XML をポストします。
しかしmodel
、実装メソッド内の値をlog.debug("Model XML = " + model);
出力すると、ログに次のような出力が得られます。
XML 自体だけを の値にするにはどうすればよいmodel
ですか? この例では、代わりにこれになりたい:
Swagger Editor が生成しているため、Java メソッド シグネチャを直接編集することはできません。私の闊歩定義が間違っている場合、XML 文字列を投稿する代わりに何を使用すればよいですか?
実際の XML は大きくなる可能性が高いため、要求パラメーターとして送信することはできません。また、XML を処理するつもりもないので、文字列として扱っても問題ありません。
asp.net - Swagger エディターの完全な API URL
オンライン Swagger エディター用の有効な Json ファイルがあります。https://mywebsite/api/apiMethodのようにテストする API の完全な URL を設定するにはどうすればよいですか