問題タブ [swagger-editor]

swagger yaml でオブジェクトの配列を定義する際に問題が発生しています。yaml の type: array 部分を定義しようとするたびに、Swagger エディターでエラーが発生します。私はそれを定義しましたが、エラーを出しているので正しくありません。以下は、swagger yaml で定義しようとしている json です。

このjsonをこのようにswagger yamlに定義しましたが、エラーが発生しています:

swagger仕様に従って、yamlでこのjsonをどのように定義すればよいか教えてもらえますか?

パラメータを変更して複数回使用されるサービスを定義する必要があります。これを複数回定義する必要がありますが、2 回目に定義するたびに、前のサービスが自動的に上書きされます。以下は私が定義した方法です。これは最初の定義です:

これは 2 番目の定義です。

1 つの API 仕様で同じパスを複数回使用することはできますか?

Swagger と Node.js を使用して、GET を呼び出したときに「Hello」を出力する単純な Hello World アプリケーションを作成しようとしていますが、次のエラーが表示されます: TypeError: res.json is not a function。Swagger Editor を使用して、次の yaml API を作成しました。

swagger エディターを使用して node.js サーバーを生成し、hello_world.js コントローラーを作成しました。http://localhost:8081/hello?name=victoryを呼び出して Swagger UI を使用してコードをテストしようとすると、次のエラーが表示されます: TypeError: res.json は関数ではありません。ここに私のnode.jsコードがあります:

私は Swagger と Node.js を初めて使用するので、エラーが発生する理由やトラブルシューティングの最善の方法がわかりません。あなたが私に与えることができる助けをいただければ幸いです。

更新: res.end(greeting) が機能することがわかりました。res.json と res.send がそうでない理由を誰でも説明できますか?

現在、Swagger UI コンポーネントで JSON をラップする方法を探しています。

YAML では、私のオブジェクト宣言は次のとおりです。

Swagger UI によって生成された出力は次のとおりです (同意しますが、正しいです)。 { "message": "string" }

そして私が欲しいのは：

YAMLファイルでラッパーを明示的に宣言することで、それを行う醜い方法を見つけました。しかし、「Swagger Codegen」を使用してクライアントまたはサーバーコードを生成するときにも生成されるため、非常に悪いです。

restExceptionContainer: restException: properties: message: type: string

必要に応じて、Swagger UI ファイルにコードを追加しても構いません。どこにあるかを見つけるためにあなたの助けが必要です:)

これは私の入力です：

そして、次のように述べています。

詳細

私は何を間違っていますか？

サンプル JSON から Swagger yaml 定義モデルを生成できるツールはありますか?

私は行って、yaml を編集してクリーンアップしますが、大規模または複雑なサンプル json オブジェクトに基づいて yaml の構造をスタブ化する何かがそこにあればいいと思います。

Swagger Editor で OpenAPI 定義を作成しています。

私の型定義の 1 つに、親と同じ型の子要素を含む配列が含まれています。つまり、次のようなものです。

ただし、Swagger Editor はchildren配列内の再帰参照を取得しません。これは単に「未定義」要素の配列として表示されます。

これを行う方法についてアイデアを持っている人はいますか?

http://editor.swagger.io/で Cookie ベースの認証を使用する API を文書化し、テストしたいと考えています。簡単な例を挙げると、次の YAML の書き方では、/login アクションが Cookie を作成し、その Cookie を /showMySecretStuff に渡す必要があります。