問題タブ [swagger-editor]

リクエストボディがjsonのPOSTメソッドREST APIがあります。

上記のjsonのバリアントのパラメーターをswagger 2.0エディターで設定する方法を知る必要があります.swaggerのドキュメントとペットストアのサンプルも参照していますが、手がかりが見つかりません.

swagger でコレクション リソースのモデルを宣言する方法がわかりません。

仕様にはいくつかの例が欠けているため、次のように推測しています。

次に、swagger エディターは、次の生成されたドキュメントを表示します。

それが正しいか？

私はswaggerエディターが初めてです。編集モードでは、APIのドキュメンテーションを非常にうまく行っています。しかし、オペラ、クロム、Firefoxではデザイナーモードが有効になりません。ブラウザでこれを有効にするにはどうすればよいですか? これは私がエディタモードで行ったサンプルです。

Desingerモードでこれを行うにはどうすればよいですか? 私を助けてください 。

配列を含むモデルから継承しようとすると、swagger エディターを使用して検証エラーが発生します。私は闊歩するのが初めてなので、私の定義が台無しになっていると思います。しかし、エディターで swagger 2.0 をサポートするために、まだやるべきことがあることはわかっています。エディターのバグや欠陥を指摘するのではなく、自分のスキーマが有効かどうかを知りたいだけです。

これはエディターで機能します (単純なペットストアの例から):

ただし、ペットを配列として定義したい：

私は闊歩するのが初めてです。

django-rest-framework で API を作成しました。それらを文書化したい。したがって、闊歩について読んでください。

django-rest-swagger を試しましたが、ドキュメントが不足しているため、コードをドキュメントに適したものにすることができませんでした。したがって、API構造を最初から設計できるswaggerエディターを試しています。ローカルにインストールしましたが、「127.0.0.1:9000」に空のページが表示されます。私は今どうすればいい ？

ローカルにインストールされたswagger-editorで消費されるYAMLまたはJSONファイルを書きたいです。どうすればこれを達成できますか?

これは、127.0.0.1:9000 をロードしたときのコンソールのエラーです。

Swagger エディターで複数行のリテラルを取得しようとしています (ちなみに、すばらしいツールです!)。

|で試してみました および>、エンディングが異なります（インデントと空行の増加）、および私が考えることができるすべての方法ですが、常に同じエラーが発生します：

問題が最後にある Windows スタイルの改行であることを示す JS-YAML のバグが見られます。これは、HTML テキストエリアが作成できることがわかっています。YAML を本格的に使うのはこれが初めてなので、何か間違ったことをしているだけなのか、それとも Swagger エディターのバグなのか?

API を文書化する必要があります。SlateまたはSwaggerのいずれかを使用する必要があります。どちらがより多くのオプション、長所と短所を持っているか、どちらが優れているかを知りたいです。

Drop-wizard と統合された swagger-jersey2-jaxrs 1.5.1-M2 があります。リソースとモデルに含めた swagger アノテーションを使用して、次の yaml を生成しました。

parameters:は、swagger から生成された yaml に含まれていることに注意してください。これをswaggerエディター2.0に貼り付けると、「配列が短すぎます（0）、最小1」というエラーがスローされます。

パラメータを生成しない方法はありますか: URLにパラメータが必要ない場合、yamlで? パラメーターの注釈を含めなかったので、生成された yaml に表示されます。