問題タブ [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.
swagger - メッセージング API の Swagger UI
以下が可能かどうか知りたいです。
Swagger は、メッセージ ベースの API を文書化するために必要なもののほとんどです。たとえば、コマンド メッセージの場合、「Post」ではなく「Command」と言いたいのですが、「path」の代わりにコマンドの名前を付けたいと思います。
仕様には、「x-」プロパティを使用してベンダー拡張が可能であると記載されていますが、1) これを行う方法の例が見つからず、2) これらのプロパティの使用が私の目標を達成するのに役立つかどうかわかりません.
先に進むのに役立つリソースを教えてくれる人はいますか?
swagger - Swagger Core Jersey 1.X の Swagger 仕様
Jersey 1 で Swagger を使用しています。Swagger 仕様 v1.2 で仕様を生成します。そこにあるほとんどのツール (例えばEditor ) は仕様 v2.0 を必要とします。仕様 v2.0 を生成する方法はありますか?
実際には、スペック v2.0 も必要とするbootprint-swagger のような印刷可能/静的ドキュメントが必要でした。
rest - HTTP GET 以外の Swagger 仕様
swagger.json 仕様がどのように機能するかを理解するのに忙しい (私の場合は api.json)。調査中に、GET リクエストを処理する方法の例を多数見つけることができましたが、POST などについては何も見つかりませんでした。私の当面の必要性は POST 部分を実装することですが、コードをコピーして貼り付け、試行錯誤に頼って機能させるのではなく、これをよりよく理解する必要があると感じています. Swagger.io Web サイトのコンテンツは初心者向けではありません。以下のコード例で何が起こっているのか、特に「get:」の後に誰かが説明できますか?
簡単な POST の例も教えてください。
swagger - 一部の操作に必須の定義でフィールドを作成する方法
私はyamlでswagger定義を書いています。このような定義があるとします。
ペイロードの id プロパティが PUT 操作に必要であり、POST 操作ではオプション (またはまったく表示されない) であることを示す方法はありますか?